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INTRODUC TION 


Telecommunications devices are being used widely to give more people 
direct access to computer services and to make computer systems more 
responsive to the needs of the people who use them. Howevers along 
with the benefits of telecommunicattons come the increased costs of 
programming for the special problems of being on-line. Burroughs 

B 1700 Generalized Message Control System (GEMCOS) ts designed to help 
reduce these costs by providing services which are common to many 
on-Line applications. 


This manual describes GEMCOS in two tevels of detail: 


ae A high-level description of components and capabilities. 
be. Detailed specifications of how to use GEMCOS. 


The material in this manual is supplemented by those portions of the 


following documents which pertain to Message Control System or Network 
Controller interfaces: 


TITLE | FORM NUMBER 


Burroughs B 1700 Systems Network Definition 
Language Reference Manual 1073715 


Burroughs B 1700 Systems User Programming 
Language Reference Manual 1067170 


Burroughs B 1700 Systems System Software 
Operational Guide 10687 31 


Burroughs 8B 1700 Systems COBOL Reference 
Manual | 1057197 


Burroughs B 1700 Systems Report Program 
Generator Reference Manual 1057189 


SECTION 1 


SYSTEM OVERVIEW 


GENERAL: 


GEMCOS is a system of programs and files whose purpose is to create 
and support a Message Control System (MCS). 


MC2_PROGRAM. 


An MCS manages the flow of messages between the Network Controller (NC) 
and the application system (see figure 171). The MCS program created 
by GEMCOS is designed to: 


ae Direct messages among telecommunications stations and 
application programs according to user-defined routes. 


be Keep unauthorized persons from using telecommunications 
Stations to gain access to the application. 


ce Limit the functions that authorized persons are allowed to 
perform. 


d. Prevent data communications errors from affecting application 
programs or from unduly crippling operations in the rest of 
the data communications network. 


e. Gather statistics about data communications errors to aid in 
diagnosing hardware problems. 


ff. Adapt dynamically to changing conditions in the network. 


ge Log messages and send them back to application programs on 
demand. 


he Bring the NC up to date regarding network status as it was 
before a failure. 


i. Effect graceful shutdown of networks, accounting for all 
messages in processe 


je Segment messages Cif necessary) to fit the buffer of 
destination stations. | 


The MCS is generative» so not all of these capabilities need to be 
present in any specific version of the MCS. The generative feature 
also allows for inctusion of user-written code in the MCS to 
supplement or supplant its standard functions. 
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GENERATOR_PROGRAMs 


The Generator programs MCSGO» creates the source code for two programs: 
the MCS and MCSFIT. The data needed to create these programs is of 
two kinds: 


ae The skeletal files» MCSGTS and MCSFTS» which are part of the 
GEMCOS package. 


b. Parameters and source codes which are supplied by the user. 


Depending on the parameters» the Generator selects source-code state- 
ments from the skeletal files» modifies thems and merges them with the 
user-written code (Cif any exists) to create programs that are fashioned 
to suit the requirements of a specific application. 


Most parameters have default values» so values need be assigned only 
for selecting features that are not in the basic (default) MCS. 


MCSTIC.AND_MCSEI IL. 
The Tabte Information Control file» MCSTIC» is used by the MCS to store 


some of its important vartables and parameters. By storing them in a 
disk file» they are preserved from one execution of the MCS to the next 
and are protected in case the MCS is abnormally terminated. The data 
in MCSTIC can be changed by the program MCSFIT.~ MCSFIT is also used to 
create a new MCSTIC file. 


AUXILIARY PROGRAMS. 


In addition to the previously mentioned programs» the system contatns 
several incidental programs. 


MCSOLI. 

The program MCSOLI allows the system operator to send control messages 
to the MCS as though at a remote station. Communication is either 
through the consote keyboard or through a card reader. 


MCSSIM. ? 
The program MCSSIM is for testing the MCS and MESS code off-line. 


Simulated input messages are presented to MCSSIM via a card reader. 
MCSSIM forwards them to the MCS as if they had come from the Network 
Controller. Outputs are printed on a system printer. 


MCSFIX. | 


This program patches and/or tists sourcecode files which are on disk 
In the User Programming Language (CUPL) format. 
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SECTION 2 


CAPABILITIES 


eee PROGRAN_INITEREACE. 


he MCS communicates with application programs through the remote file 
iti ee but 1t provides some opttonal extensions to the standard 
interface. Application programs may be written in any language that 
supports remote or data communications files. 


A standard remote file provides a tink between an application program 
and one or more data communications stations» which have been declared 
as belonging to that file in the FAMILY statement of NDL. Messages 
are exchanged in the record area of the file. In COBOL» an actual key 
can be used to exchange information about the message» namely» message 
type» message length» and source or destination station. Stations are 
identified by a number which is relative to the order in which the 
Stations were assigned to the file in the FAMILY statement. 


GEMCOS offers as an optional feature Supplementary Information Data 
(SID)» which overrides portions of the standard interface. The SID 

is a header which appears in the record area of a file in front of the 
message. The SID contains the following fields: 


ae Logical Station Number (LSN) = identifies the source or des- 
tination station. The LSN is a number which is relative to 
the order in which stations are defined in the station section 
of NOL. This identifier is not necessarily the same as that 
used in the actual key of COBOL. 


NOTE 
The LSN of a given station changes if 
Stations are presented ina different 
order when the NOL 1s recompiled. 


be Message type - distinguishes between normat messages and 
messages used for special purposes» such as restoration. 


Ce. Sequence number - assigned by the MCS» primarily to aid in 
restoration. 


d. NDL time - contains the time at which the NC sends the 
message to the MCS. 


e. Message text size - on incoming messages» indicates the length 
Cin bytes) of the messages not including the SID header. 


f. Terminal type - identifies the kind of terminal or device 
from which the message originated. 


When the SID optton is used» the MCS attaches the SID header to each 
message sent to an application program and removes it from each mes- 
sage received from an application programs so that the SID header does 
not accompany the message on the NC side of the MCS. 


The actual key in COBOL should only be used for specifying the text 
size of an outgoing message. 


When an application program receives a message from the MCS» the LSN 
field in the SID is set to the originating station. As long as the 
LSN remains unmodified at the time the application sends a response 
back to the MCS» then the MCS will route it back to the same station. 
But» if the application requires that the response be sent to some 
other stations then that is accomplished by merely changing the LSN 
field to the correct value for the other station. 


TBANSACTION-“BASEQ. ROUTING: 

By using the FAMILY statement of NOL» the network designer can assoc- 
jate a tist of stations with a remote file name. When an application 
program successfully opens a remote files the stations in the family 
associated with that file become» in a senses “attached* to that pro- 
grame From that time on» the NC will route messages from that famity 
of stations only to the program that opened the file. 


GEMCOS» howevers offers an optional alternative to station attachment: 
Transaction Based Routing (TBR)Y.~ Messages may contain transaction 
codes anywhere in the text. TBR allows a group of transaction codes 
to be associated with each application programs» so that a message 
containing a specific transaction code will always be routed to the 
same programs regardtess of the source of the message.w A stations 
then» can send a message to any program (subject to security restric- 
tions) by including in the message one of the transaction codes assoc- 
iated with that program. If a message does not have a transaction code 
or the transaction code is invalids then the message will be sent to 
the program which is attached to the originating station. If no 
program is attached to that station» the message is rejected. 


Only the first remote file opened by an application program receives 
input messages which have been routed by TBR. Any additional files 
that may be opened by the same program receive input only from stations 
which have been attached to those files. Therefores when TBR is used» 
the first remote file opened by a program must be opened INPUT or 
INPUT/OUTPUT. Failure to do so results in rejection of TBR messages. 


SECURITY. 


In GEMCOS there are two types of security: access security and process 
security. Access security is designed to prevent unauthorized persons 
from using the system. Process security limits the functions that 
authorized persons are allowed to perform. A specific MCS may be gen- 
erated to contain logic for access security alone or for both access 
security and process security. 


ACCESS SECURITY. 

Access security is implemented through sign-on and sign-off messages. 
Some stations may already be physicatly secures therefore» signing on 
is not necessarily required for all stations. Each installation may 
specify which stations do not require signing on. 


The sign~on message requires that each potential terminal user supply 

a userridentification code (user“ID) and password. GEMCOS uses the 
MCSTIC file to store a list of user-ID's and passwords which are valid 
for a specific installation. MCSFIT can be used to update this list. 
At any specific time a user may be either enabled or disabled. If 
disabled» then that user 1s not altowed to sign on until enabled again. 


A user is allowed to sign on only if all of the following conditions 
holds 


ae The station requires signing on. 
b. The station is not already signed on. 
ce The user enters a valid combination of user-ID and password. 


A user wilt be allowed to enter a data message only if one of the 
following conditions hold: 


ae The terminal does not require signing on. 
b. The user 1s signed on. 


The same user~ID can be used to sign on at several terminals 
simultaneously. 


PROCESS SECURITY. 
GEMCOS offers two types of process security: 


ae Transaction security ~ for timiting which transaction codes 
can be entered by a signed-on user or at a station which does 
not require signing on. 


be. Program security - for limiting which programs can be used by 
a signed-on user or through a station which does not require 
signing one Program security 1s used when messages do not 
have transaction codes or when transaction security is not 
being used. 


Transaction security and program security can be selected either 
separately or in combination through generation parameters. 


Process security uses the concept of security levels. Each user and 
each station which does not require signing on must be assigned an 
upper and lower security timit which defines a range of valid security 
level numbers. When transaction security is used» each transaction 
code must be associated with a specific security tevel number. A 
particular transaction code can only be used if its security tevet 
number fatts within the range of security level numbers associated 
with the originating station or user. When program security 1s used» 
a security lLevet number must be associated with each program for which 
security restrictions are needed.j A station or user can communicate 
with a given program only if the security level number for that program 
falls within the range of security tevel numbers associated with the 
station or user. 


If necessary» process security can be used to ensure that a program 
only receives messages which have been routed by TBR. Ordinarilys a 
message which does not have a recognizable transaction code is sent to 
the program to which the originating station is attached. Howevers if 
the security tevel of that program is not within the security range of 
any user or stations then such a message is rejected. 


Security level information for users and stations is stored in the 
MCSTIC files where it can be readily updated. 


Refer to appendix G for an example of security specifications. 


NETWORK AQMINSIRALION. | 
Even though the MCS and NC automatically control many aspects of the 


networks there are still some conditions which require human inter- 
vention. For this reason» GEMCOS supports the concept of a Network 
Manager. 


One station can be designated as the Network Manager's stations and 
one or more users can be designated as a Network Manager. In case 
there is no Network Manager or the Network Manager's station is not 
available» then the consote printer of the computer system can be 
used as a Network Manager's station with the aid of the program MCSOLI. 
A Network Manager adminsters the network by using Network Control 
Commands (NCC's). GEMCOS recognizes NCC syntax for the following 
functions: | ; 

ae Security. 


1) Enable and disable users. 
2) Sign on and off. 


b. MCS control. 
Ce Message control. 


1) Reroute messages. 
2) Retrieve queued messages. 
3) %Send messages to other stations. 


ds. Program control. 


1) Execute and terminate application programs. 
2) Report program status. 


e. Network status. Report and change status of: 
1) Lines. 
2) Stations. 
3) Terminals. 
The MCS need not contain togic to execute allt of these commands. There 


are generation parameters to specify which commands are needed. 
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Use of NCC's is restricted by the security subsystem of GEMCOS.~ Some 
commands» due to their very natures can be entered by anyone at any 
Station (for examples» the sign-on and sign-off commands)» but many com- 
mands can only be entered at the Network’*Manager's station. If access 
security is in force and the Network Manager's station requires signing 
ons then a user defined as a Network Manager must be signed on at that 
station before any restricted NCC's can be entered. Alt NCC*%s can 
always be entered at the console keyboard without restriction. AlLl 
NCC*s Cexcept one) can be initiated by an application programs however» 
the program must be prepared to handle responses. 


CRROR_WANDLINGs 


The primary goat of the error handling subsystem in GEMCOS is to make 
1t unnecessary for applications programmers to be concerned about 
writing logic to handle error conditions which are not directly related 
to the applications task at hand. The policy of GEMCOS tn handling 
errors 1s: 


ae Take enough automatic action to keep the data communications 
system running. 


b. Inform some person who has the power to correct the problea. 
GEMCOS recognizes three categories of errors: 


ae Errors made by a station operator. 
b. Persistent data communications errors. 
ce System errors. 


When a GEMCOS MCS detects errors made by a station operators error 
messages are sent back to that operator. For other kinds of errors» 
messages are sent to the Network Manager's station or to the console 
printers» if the Network Manager's station 1s not available. Network 
Control Commands may then be used to hetp diagnose the problem or 
circumvent it. | 


The NC handles transtent data communications errors» but persistent 
errors are reported to the MCS. The MCS not only reports such errors 
to the Network Manager but also keeps error statistics. Statistics 
are accumulated by line and by station. They can be retrieved by 
using Network Control Commands. 


System errors result either from I/0 errors on peripheral devices used 
by the MCS or from software problems in the MCS» the NC» or the 
applications programs. When a system error is detected» the MCS re- 
ports the error to the Network Managers identifying the routine in 

the MCS which discovered the error. In case of serious errors» the 
MCS also produces a dump of its tables for debugging purposes. The 
MCS is designed» howevers not to stop running unless the Network 
Manager or system operator discontinues it. | 


NETWORK BESTORAIION: 


The purpose of network restoration is to bring the data that the NC has 
about network status up-to-date with data that the MCS has. Network 
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status consists of information such as the current physical address of 
a stations or whether a line is *alive™ or "dead." The MCS keeps 
current network status information in the disk file MCSTIC>» where 

it 1s safe from abnormal program termination. 


Each time the MCS is executed» it uses the status data from MCSTIC 
to generate commands for the NC. The NC uses these commands to update 
its tables in main memory. 


Network restoration is done automatically. [t can» however» be sup- 
pressed by using MCSFIT to reset the restoration flag in MCSTIC before 
executing the MCS. 


MESSAGE RESTORATION. 


The message restoration feature of GEMCOS is destgned to help appli- 
cation programs recover from failure. Restoration is made possible by 
an audit trail. Through generation parameterss an MCS can be created 
with just the audit feature or with both audit and restoration. 


AUDIT. 

When the audit option ts useds the MCS keeps an audit trail of all 
messages sent to an application program. (COptionally» alt other output 
messages from the MCS can be audited» too» but only messages to pro- 
grams are needed for restoration.) Messages are identified by a 
sequence numbers» which the MCS assigns. The SID option must also 

be used» so as to provide a means for communicating the sequence 

number to application programs. 


The audit trail is written on a disk file. When the audit file becomes 
filled» it 1s closed and a new one is opened. The full file is then 
available for copying to another device. Each new audit file has a 
file identifier which is different from the last. The MCS displays on 
the consote printer the date of creations and beginning and ending 
sequence numbers. The system operator needs this information to aid in 
identifying the correct audit file when restoration is invoked. 


RESTORATION. | 

When an application program is ready to begin restorations it sends the 
MCS a message which has a special value in the type-code field and con- 
tains a sequence number and date. Using the audit file created on that 
date and beginning with the message after the specified sequence number» 
the MCS sends back all messages up through the most recent. The appli- 
cation can distinguish between normal messages and restoration messages 
by the type~code field in the SID. As soon as the first normal message 
is received» restoration is complete. | 


Whenever the MCS requires an audit file other than the current ones it 
displays a request on the console printer. For the first audit files. 
the MCS displays both the sequence number and date which were in the 
restoration request sent from the application program. For successive 
audit files» the next sequence number in order is displayed. 
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CONTROLLED SHUTDOWN. 

When a data communications system terminates operations» messages may 
be lost in the process of terminating unless special care is taken. 
In GEMCOSs» system shutdown consists of the following steps: 


ae A message 1s sent to all stations» informing them that 
shutdown has started. 


be. Further input is disabled. 
Ce The MCS causes an end-of-file condition on all remote files. 


de Any messages that may remain tn the queues of the NC are 
recalled and printed on a tine printer. 


e. <A message 1s sent to the NC» causing it to terminate. 
f.~ The MCS terminates. 


Any messages that could not be delivered to their destinations are 
accounted for on the printer listing. 


MESGEABLE_EXTERNAL_QOURCE STATEMENTS. 


Mergeable External Source Statements (MESS) are for specialized re- 
quirements which demand deviation from the standard logic of GEMCOS. 
User-written MESS routines can be merged into key spots in the MCS 
logic. Each routine must be a procedure in User Programming Lan- 
guage (UPL).~ Att MESS routines are optional. Most MESS routines can 
either replace or supplement standard GEMCOS logic. 


Following is a list of the places where MESS procedures can be tn- 

serted. The intended function of each procedure is explained» but» 
in fact» there is practically no Limit to the functions that can be 
coded. 


ae Receiving message from station - for formatting» pagings or 
routing. 


be. Receiving message from program - for formattings paging»s or 
routing. 


ce Processing NCC*s = for extending or replacing the capabilities 
for network control. 


d.- Auditing - for replacing or supptementing the standard audit 
feature. 


ee Error handling - for extending the standard errorshandling 
logic. | 


fe. Opening - for processing that needs to be done as the system 
starts UD e 


ge Closing - for processing that needs to be done as the system 
is shut downs» such as closing files used by other MESS 
procedures. 


he Recalling messages - for disposing of unsent messages when the 
system is shut down. 


ies Initiating restoration - for processing the request of an 
application program for restoration. 


je Restoration - for replacing the standard restoration logic. 


The source code for MESS procedures is submitted to the Generation 
Program along with the generation parameters. The Generator then 
merges these procedures into the correct places tn the MCS togic. 


DEBUGGING. AIQS. 
GEMCOS offers two kinds of debugging aids: a data dump and a togic 


fiow monitor. The existence of these features is controtted by 
generation parameters. 


DATA OUMP. 

The data dump provides a snapshot of the state of the MCS and its 
environment. It displays the contents of the tables» certain signif- 
tcant data items» and the message work area. It can be used not only 
for debugging purposes but also for reporting statistical information 
which is kept in the tables. | 


A data dump can be created in any of three ways: 


ae On demand» via a Network Control Command. 
be Automatically» when the MCS detects a serious error. 
ce Pertodicatly»s» at an interval which 1s dynamically changeable. 


MONITOR. 

The monitor is a procedure within the MCS which produces a listing 
that can be used to trace logic fiow.e. At the entrance to every pro- 
cedure and at other key points in the MCS are calls on the monitor. 
Since MESS procedures can also call on the monitors the monitor is a 
valuable tool for debugging interfaces between MESS code and the 
standard MCS. 


The monitor Listing displays: 
ae An identification of the procedure now executing. 


be. An identification of the procedure which calted the current 
procedure. 


ce Any information that 1s pertinent to the current procedure. 


Since the monitor is a generative options the MCS that is used for 
normal operation does not have to suffer the overhead of monitor 
logic. Users can generate a second MCS which is exactly like the 
production MCS except that the MONITOR generation parameter is set. 
This second MCS would be used only if problems arise which cannot 
otherwise be diagnosed. 


When an MCS has been generated with the MONITOR parameter set» the 
monitor listing can be turned on and off either dynamically» by an 
NCC» or between executions of the MCS» thru MCSFIT. Furthermore, 
monitor can be setected for individual procedures» so that the only 
procedures which need be monitored are those which are suspected of 
being related to the problem. 


SECTION 3 


INTERFACES 


GENERATION_PARAMETERS:2 


Generation parameters are given tues in an assignment statement of 
the form: 


Aexk*e Darameter-name = value. 


A value can be of type Booleans strings or numeric. Boolean values are 
either TRUE or FALSE. String values consist of a series of alpha=~ 
numeric characters enclosed by quotation marks. Numeric values consist 
of a series of the digits 0 thru 9. The value assigned to a parameter 
must agree with the type required by that parameter. The control code 
Zxxexb Cwhere the “b*™ stands for the character blank) must appear in 
columns 1 thru 5.2 The rest of the assignment statement can appear 
anywhere in columns 6 thru 72. 


Following are examples of each type of value: 


eee MESS@SIZE = TRUE. 
Zeek MESS@“SIZE~*NAME = “"SIZE.MAKER™. 
Ze*e*e MGR-“STN“LSN = 2. 


A Boolean parameter which has the value TRUE is said to be “set™s one 
with the value FALSE 1s said to be "reset." 


A parameter name may» in some cases» be subscripteds for example: 
ZAexe PRO“-SEC“LEVC1) = 53. 


In case it 15 necessary to assign values to an array of parameterss a 
shorthand notation can be used. For examples the assignment statement: 


Zeek SCREENWSIZECL) = 2565 128» 1024. 


is equivalent to the following three assignment statements: 


%eex SCREEN-SIZEC1) = 256. 
%eee SCREEN-SIZE(2) = 128. 
%exe SCREEN-SIZE(3) = 1024. 


Likewise» the assignment statement: 
Zeek TO“SEC“LEVC 251) = 355% 26» 13. 


is equivalent to: 


%eee TC“SEC“LEV( 21) = 35. 
%eee TC-SEC“LEV(2-2) = 26. 
%eee TCSEC“LEV(2>3) = 13. 


When multiple values are used in an assignment statements the last 
subscript of the parameter name is incremented by one for each 
additional value. 


ROUTING AND SECURITY PARAMETERS. 

These parameters are for defining programs and transaction codes» 
selecting routing and security options» defining routing criterias 
and setting security tevels. Refer to table 3-1 for a summary. 


Table 3-1 


Routing and Security Parameters 


PROGRAMCi) string 
SID Boolean 
TBR 1 Boolean 


ACCESS=SECURITY Boolean 
TRANSACTION-SECURITY Boolean 
PROGRAM*SECURITY | Boolean 
TRAN-“CODE C1» 43) string 
TC“COL*POSITIONCi» jd? | numeric 
TC“SEC@LEVCi»j) numeric 
PRO@SEC*LEV(1) numeric 


Following is a detailed explanation of these parameters: 


de 


PROGRAMCi1) = identifies one of the programs which will use 
either the TBR or security features. Programs which do not 
use these features need not be defined here. Subscripts must 
be assigned contiguously from 1 through the number of programs 
to be defined. The value of a program identifier is 30 
characters long. The 30 characters are divided into three 
groups of 10 characters» corresponding to the three parts of a 
file name. For examples suppose the following programs are 

to be defined: 


A 

A/B 

A/B/C 
A123456789/B123456789/7C12 34565789 
A/B/ 


de 


Then the parameter assignment statements to define these 
programs are: 


zZ*xxe PROGRAM(1) = * A *. 
Zee PROGRAMC2) = *™ A B ". 
Zee PROGRAM(3) = * B C ". 
Zeek PROGRAMC4) = "A123456789B123456789C0123456789". 

= "A B at 


Zexex PROGRAMCS) 


The first 10 characters are reserved for the disk pack iden- 
tifier» if one exists. The second 10 are for a family name> 
if one exists; otherwise they are for the fite identifier. 
The third 10 are for the file identifier» if a family name 
is in the second 10. Within each group of 10 characters» 
the identifter should be tleft-justified. 


SID = determines whether the Supplementary Information Data 


header witl be used. SID is automatically set when TBR is 


set. If SID is sets» the PARTICIPATING 1s also set. 


TBR - determines whether the Transaction Based Routing feature 
1s to be used.~ When TBR is set» values must also be assigned 
to PROGRAM(C1)» TRAN“CODECi»j)» and TC“COL=POSITION(C1>j). 

SID and PARTICIPATING are automatically set. 


ACCESS=SECURITY - specifies whether access security logic is 
to be included in the generated MCS. When ACCESS-SECURITY 
is set» user and station security information must be loaded 
into MCSTIC using MCSFIT. 


TRANSACTION“SECURITY = specifies whether transaction security 
logic 1s to be included in the generated MCS. If TRANSACTION- 
SECURITY is sets» values must also be assigned to the relevant 
TRAN“CODEC1)» TC“COL“POSITIONCi»>j)» TC-SEC“LEVC1>j)» and 
PROGRAM(C1) parameters» and ACCESS“SECURITY must also be set. 
PARTICIPATING is automatically set. Upper and lower security 
level bounds must also be assigned to user-IO0's and/or 
stations by using MCSFIT. 


PROGRAM-SECURITY = specifies whether program security logic 1s 
to be inctuded. If PROGRAM=SECURITY is sets» values must also 
be assigned to the relevant PROGRAMC1) and PRO“SEC-LEV(1) 
parameters» and ACCESS“SECURITY must also be set. 
PARTICIPATING is automatically set. Upper and lower security 
level bounds must also be assigned to user-ID's and/or 
stations by using MCSFIT. 


TRAN“CODEC1>j) - defines transaction codes so they can be 
recognized by the MCS. The subscript “i™ is the same as that 
of the program to which messages containing this transaction 
code will be routed. For any’ specific programs subscript "j*™ 
must range from one through the number of transaction codes 
which are to be routed to that program. For examples the 
parameter assignment | 


meee TRAN“CODEC251) ="INQ™. 


specifies that a message with "INQ" in it should be sent to 
the program identified by the parameter PROGRAM(2). A value 
must also be assigned to the parameter TC-COL“-POSITION(C 1,3). 


TC-COL-POSITIONCi»j) - specifies the character position within 
the message text at which TRAN-CODEC1»j) 1s expected to appear. 


TC“SEC“LEVCi»j) - defines the security level for TRAN-. 
CODEC1»>j). The integer vatue of TC“SEC“LEVCi»j) must be 
between 0 and 99» tnclusive. Other parameters that must also 
be assigned are the corresponding TRAN“CODECi»~j)» TC-COL- 
POSITIONC1»j)» PROGRAM(C 1)» and PRO-SEC“LEV(1). 


defines the security tevel for PROGRAM(1). 
inclusive. The 


PRO“SEC*LEV(1) = 
The integer value must be between 0 and 99.5. 


corresponding PROGRAM(1) parameter must also exist. 


NETWORK CONTROL PARAMETERS. | 
These parameters are for setting up the Network Manager's station and 
for selecting which network control capabilities need to be included 


in the generated MCS. 


Refer to table 3-2 for a summary. 
Table 3-2 


Network Control Parameters 


Boolean 
numeric 
string 
Boolean 
Boolean 
Boolean 
Boolean 
Boolean 
Boolean 
Boolean 
Boolean 


MGR=“STN 
MGR=STN*LSN 
NCC-GK-RESPONSE 
CHANGE=REQ 


DATA~DUMP 
MSG-BROCST 
MSG*RECALL 
PGM=BOJ“EOJ 
STATUS*REP 
SYS*HALT 
TABLE-DUMP 


Fotlowing is a detailed explanation of network control parameters: 


ae 


be 


d. 


j. 


MGR-“STN - indicates whether to generate logic for handling a 
Network Manager's station. 


MGR*STN“LSN = specifies the Logical station number of the 
Station to be used as the Network Manager's station. This 
parameter is meaningful only if MGR<-STN is set. 


NCC“OK“RESPONSE - defines the message to be returned to a 
station upon successful completion of a Network Control 
Command. 


CHANGE-REQ - determines whether to include logic to process 
the ten change request NCC*s: CLR» CLL» CSA» CSE» CSRe CSTs 
CSF» CSD» CSM» and CSQ. 


DATA~DUMP = indicates whether to include logic for creating a 
dump of internal MCS variables. If resets» the RDM command 
will not be recognized. 


MSG-BRDCST = tells whether to generate code to execute the 
broadcast NCC CBRC). 


MSG"RECALL - tells whether to generate logic for the NCC PQ 
(pop queue). 


PGM"BOJ“EOJ - specifies whether code is needed for the two 
program-control NCC'ss EX Cexecute program ) and HAP Chalt 
application program). 


STATUS“REP - tells whether to itnclude logic for processing the 
seven NCC*s which request status reports: RFS» RLS» RLC» RSS» 
RSC» RTS» RPS. 


SYS“HALT =- tells whether to generate code for handling the 
HLT NCC. If SYS“HALT its set» CHANGE=REQ is set automatically 
in order to inctude enough logic to bring the system to an 
orderly halt. 


TABLE-DUMP - tndicates whether logic is needed for creating a 
data dump pertodically. If TABLE=DUMP is sets» then DATA=DUMP 
and CHANGE-REQ are set automatically» and the CRV command is 
recognized. 


AUDIT AND RESTORATION PARAMETERS. 
These parameters are for selecting audit and restoration capabilities. 
Refer to table 3-3 for a summary. 


Table 3-3 


Audit and Restoration Parameters 


AUDIT Boolean 
AUDIT~ALL~OUTPUT Boolean 
AUDIT=PAGE-SIZE numeric 


RESTORATION Boolean 


Following is a detailed description of these parameters: 


de 


be 


AUDIT - tetts whether the generated MCS is to contain logic 
for auditing. 


AUDIT*ALL~OUTPUT = specifies whether all output messages from 
the MCS should be audited. If reset» only messages bound for 
a program are audited. If set» AUDIT is automaticatly set. 


AUDIT“PAGE“-SIZE - controls the size of the audit files by 
specifying the number of records in each page (Cor area). 
There are altways 40 pages. 


RESTORATION = determines whether the standard program restor- 


ation 1s to be tincluded.~ When RESTORATION is sets» AUDIT 1s 


automatically set. 


OPERATIONS PARAMETERS. | 
These parameters are for controlling the generation process. Refer to 
table 3-4 for a summary. 

Table 3-4 


Operation Parameters 


MAKE =-MCSSRC Boolean TRUE 
COMPILE-MCSSRC Boolean TRUE 


MCSSRC“COMPILE-OPTIONS string "NO LIST NO~OUPLICATES” 
MCSSRC“OBJECT“FILE=NAME string "MCSSRC/OBJECT* 
MAKE-MCSFIT Boolean TRUE 

COMPILE-MCSFIT Boolean TRUE 
MCSFIT-COMPILE-OPTIONS string "NO LIST NO.~DUPLICATES* 
MCSFIT*OBJECT“FILE-NAME string "MCSFIT/OBJECT® 


Following 1s a detailed explanation of operations parameters: 


ae MAKE-MCSSRC - instructs the generator whether to create the 
source file of the MCS. 


be COMPILE-MCSSRC - tells the generator whether to cause com- 
pilation of the generated source program as soon as it 15 
created. | 


Ce MCSSRC“COMPILE-OPTIONS =~ allows specification of compiler 
control statements when COMPILE-MCSSRC 1s set. Refer to the 
UPL manual for a complete description of available options. 


de MCSSRC~OBJECT-FILE-NAME —- allows specification of the object 
program name when COMPILE“MCSSRC is set. 


ee MAKE-MCSFIT - instructs the generator whether to create the 
source file of the program MCSFIT. 


f. COMPILE-MCSFIT - tells the generator whether to cause 
compilation of the generated source program as soon as it 1s 
created. | 


ge MCSFIT-COMPILE-OPTIONS - allows specification of compiler 
controt statements when COMPILE“MCSFIT 1s sete Refer to the 
UPL manual for a complete description of available options. 


he MCSFIT*OBJECT“FILE“NAME - allows specification of the object 
program name when COMPILE<-MCSFIT 1s set. 


MESS PARAMETERS. 

These parameters are for indicating the existence of MESS procedures» 
ands if desired» for assigning user-defined names to them. Refer to 
table 3-5 for a summary. 


Table 3-5 


MESS Parameters 


GLOBAL=SECTION 
PROCEDURE“SECTION 


MESS*NAME@STACK@“ENTRIES 


MESS“VALUE“STACK@“BITS 
MESS~AUDIT 
MESS“AUDIT=NAME 
MESS“CLOSE 
MESS*CLOSE*NAME 
MESS“ERROR 
MESS“ERROR=NAME 
MESS“FROM-PGM 
MESS“FROM=-PGM=-NAME 
MESS“FROM=STN 
MESS“FROM=STN-NAME 
MESS“MAINT 
MESS@MAINT“NAME 
MESS@“RECALL 
MESS“RECALL~NAME 
MESS“RESTORE 
MESS*RESTORE-INIT“NAME 
MESS-RESTORE-PROG- NAME 
MESS-SIZE 
MESS*SIZE~NAME 
MESS“VALUE 
MESS“VALUE“NAME 


Boolean 
Boolean 
numeric 
numeric 
Boolean 
string 

Boolean 


string 


Boolean 
string 
Boolean 
string 
Boolean 
string 


| Boolean 


string 


Boolean. 


string 
boolean 
string 
string 
Boolean 
string 


Boolean 


string 


FALSE 

FALSE 

0 

0 

FALSE 

"MESS.AUDIT" 

FALSE 
"MESS.CLOSE.FILES” 
FALSE 

"MESS -eERROR eHANDLER*® 
FALSE 
"MESS.MSG.FROM.PROGRAM™ 
FALSE 
"MESS.MSGeFROM.STATION® 
FALSE 
"MESSeMAINTENANCE”® 
FALSE 
“MESS.HANDLE-RECALL” 
FALSE 
"MESS-INITIATE-RESTORE® 
"MESS~RESTORE.}PROGRAM* 
FALSE 

"MESS.SET.SIZES*” 

FALSE 

"MESS.SET.VALUES”* 


The Boolean parameters which begin with "MESS=<" indicate whether cer- 
tain MESS routines are being supplied by the user. For each of these 
Boolean parameters there is at least one string parameter (ending in 
"=-NAME") which can be used to assign a user-defined name to the pro- 
cedure. For each possible MESS routines the Generator needs to know 
whether it exists ands if sos what its name is so that the proper pro- 
cedure calls can be generated. The other parameters (those not 
directly associated with specific MESS routines) are explained below: 


ae GLOBAL=-SECTION - indicates whether there are any source state-~ 
ments global to any of the MESS procedures. Global statements 
may be used» for example» to define data areas or files which 
are shared by several MESS procedures. 


be PROCEDURE-SECTION = indicates whether any MESS procedures 
existe 


Ce MESS“NAME“STACK-ENTRIES - specifies the maximum number of 
name stack entries that need to be reserved for variables 
declared in MESS procedures. 


de MESS-“VALUE*STACK-BITS = specifies the maximum number of value 
Stack bits that need to be reserved for variables declared 
in MESS procedures. 


The parameters MESS=NAME*STACK-ENTRIES and MESS=VALUE*STACK-BITS are 
used to insure that stack sizes are large enough to execute an MCS 
which contains MESS procedures. If the values of these parameters 
are not great enoughs a name or value stack overflow error may occur 
when the MCS is executed. 


Name stack entries are used to store information about vartables. One 
name stack entry is used for each data name that appears in a DECLARE 
statement» except that two entries are needed to store all the 
information about an array. 


Values of variables are stored in value stack bits when the values are 
longer than 24 bits. If the value of a variable is 24 bits tong or 
less» then the value is stored in the name stack entry of that 
variable. Values of all arrays are stored in the value stack. 


Table 3-6 illustrates how to calculate stack sizes for a sample data 
declaration. 


Tabte 3-6 


Calculation of Stack Sizes 


Name 


Declarations Stack 
Entries 


DECLARE 

CHAR. VARI CHARACTER(2)> 
CHAR. VAR2 CHARACTER(S)» 
BIT.VAR1 BITC10)> 
BIT.~VAR2 3BITC45)>» 
CHAR.ARRAY1(2) CHARACTERC1)> 
CHAR.~ARRAY2(4) CHARACTER(1)>» 
~BIT.~ARRAY1(€10) BITC1)>» | 
BIT. ARRAY2(24) BITC4)>» 
FIXED.VAR FIXED> 
FIXED»ARRAY(3) FIXED; 


1 
1 
1 
1 
2 
2 
2 
2 
i 
2 


For the example in table 3-6 the total number of name stack entries 
needed is 15» and the total number of value stack bits needed 1s 311. 


Calculation of what values to assign to these parameters is further 
complicated by the fact that name and value stack space for variables 
declared tocally within a procedure is atlocated only when that pro- 
cedure is invoked. The space is returned when that procedure is 
exited. Thus» the amount of stack space that must be reserved is the 
maximum space that wiltl be used at any given time. This is usuattly 
less that the total of stack space needed for all variables dectared. 


MISCELLANEOUS PARAMETERS. 
These parameters are for setting sizes of MCS tables and for 
controlling various MCS features. Refer to table 3-7 for a summary. 


Table 3-7 


Miscellaneous Parameters 


PARTICIPATING Boolean 
MONITOR Boolean 
SCREEN@WRAPAROUND Boolean 
SCREEN@SIZECi) numeric 


MAX@“FILES numeric 
MAX@LINES numeric 
MAX=PROGRAMS numeric 
MAX=STATIONS numeric 
MAX-TERMINALS numeric 
MAX@=TEXT=SIZE numeric 
MAX-USERS numeric 


Fotlowing is a detailed description of the miscellaneous parameters: 


ae PARTICIPATING ~ tndicates whether the MCS 1s to participate in 
I/0 between programs and stations. In generals a nonparti- 
cipating MCS 1s somewhat quicker» but its capabilities are 
Limited to the processing of NCC's. PARTICIPATING its auto- 
maticatly set when features are selected which require 
participation. 


be MONITOR - indicates whether to generate togic for the debug 
monitor. If MONITOR 1s set» CHANGE“REQ 3s automatically set 
in order to include Logic for handling the CMF (change monitor 
flag) NCC. Howevers if CHANGE-REQ is set and MONITOR is 
reset» CMF 1s not recognized. 


Ce SCREEN“WRAPAROUND - indicates whether messages are to be auto- 
matically segmented to fit the screen size of the destination 
station. If set» then a value must be assigned to SCREEN- 
SIZEC1i) for all stations. PARTICIPATING is set automatically. 


de SCREEN“SIZE (Ci) = specifies the length of the largest message 
that can be sent to a station. The subscript "i" is the 
Logical station number (LSN) of the station. When SCREEN- 
WRAPAROUND is set» a message sent to station "i" which is 
longer than SCREEN“SIZEC1) will be broken down into two or 
more shorter messages. 


ee MAX-FILES - specifies the maximum number of remote files 
which can be open at one time. Attempts to open more files 
are denied. 


f. MAX*LINES = specifies the maximum number of tines that can 
exist in the network. This must be equal to or greater than 
the number of lines defined in the line section of NOL. 


ge MAX=PROGRAMS - defines the greatest number of data 
communications programs that may be executing at one time. 


he. MAX=STATIONS = specifies the maximum number of stations that 
can exist in the network. This number must be equal to or 
greater than the number of stations defined in the station 
section of NODL. 


Te MAX=*TERMINALS = specifies the maximum number of terminals that 
can exist in the network. This number must be equal to or 
greater than the number of terminals defined in the terminal 
section of NDL. 


j- MAX=TEXT=$SIZE = defines the size in characters of the longest 
message that can pass through the system. : 


k. MAX“USERS = specifies the maximum number of users that can be 
defined to the MCS. This 1s also the maximum number of “"USR* 
cards that can be submitted to MCSFIT. The value assigned 
to MAX“USERS must not be greater than 999. 


2IQD_INIEREACE. 


All fields in the Supplementary Information Data header are in 4~bit 
numeric format (PIC 9€n) COMP). Refer to table 3-8 for the Layout. 


Table 3-8 


SID Layout 


| Field Description Length in Digits 


LON 
MESSAGE TYPE 
SEQUENCE NUMBER 
NDtL TIME 

TEXT SIZE 
TERMINAL TYPE 


Following 1s a detailed explanation of each of the fields in the SID: 


ae LSN (Logical Station Number). For tncoming messages this 
field contains the LSN of the originating station. Qutgoing 
messages are sent to the statton whose LSN 1s stored in this 
field. 


b. MESSAGE TYPE. The value of this field is zero for normal 
messagese The application program sets it to a value of 1 to 
Initiate restoration. At this time the sequence number field 
must identify the last completed transaction and the first six 
characters of text must contain the date of the audit file for 
that transaction. Format of the date is “"mmddyy™. Ouring 
restoration the MCS sets the MESSAGE TYPE to 1 for all mes- 
sages coming from the audit file. The MCS sets it back to 
zero again with the first normal messages thereby indicating 
end of restoration. 


Ce SEQUENCE NUMBER. The MCS assigns this number to all messages 
it sends to an application program. The application program, 
if it needs. restorations must send back to the MCS the 
sequence number of the last complete transaction. 


de NOL TIME. This is the time at which the NC sends the message 
to the MCS. | 


ew TEXT SIZE. For incoming messages» this is the length in 
characters of the message text. It does not include the 
length of the SID. It is set by the MCS for incoming mes- 
sages. A text size of zero means that only the SID is being 
sent. For outgoing messages» the actual key must be used to 
specify text size. In this case the size must include the 
size of the SID. 


fe. TERMINAL TYPE. The MCS sets this field to a code which 
identifies the type of the originating device. Terminal 
type codes are assigned in the terminal section of NOL. 


A COBOL language definition of the SID might look Like thiss 
01 MESSAGE“RECORD. 


02 SID-AREA. 
03 LOGICAL“STATION“NUMBER PIC 9€4) COMP. 


03 MESSAGE“TYPE PIC 9(€2) COMP. 
03 SEQUENCE =NUMBER PIC 9(€6) COMP. 
03 $$NDL=TIME PIC 9¢€8) COMP... 
03 TEXT-SIZE PIC 9€4) COMP. 
03 TERMINAL“TYPE PIC 9€{2) COMP. 
02 TEXT*AREA PIC X(€maxsize). 
MESS PROCEDURES. 


Atl MESS procedures are optional. If one is to be included» then the 
corresponding generation parameter must be set so the Generator can 
build a statement which invokes the procedure. User=defined names can 
also be given to MESS procedures via generation parameters. 


MESS code is divided into two sections: a global section and a 
procedure section. The global section contains: 


ae Alt DEFINE statements. 


be. ALt FILE statements. 


ce Any DECLARE statements for data items that are to be shared 
among MESS procedures» except for DECLARE DYNAMIC statements. 


The procedure section contains: 


ae All DECLARE DYNAMIC statements. 
be ALL PROCEDURE declarations. 


Care must be taken in writing MESS code to avoid duplicating iden- 
tifiers already used in the MCS. For this reasons all MCS identifiers 
adhere to the following conventions: | 


ae DEFINE’S begin with the three characters "MD." or "MS.". 
be Files begin with the three characters “MCS*. 

ce. Data names begin with the three characters "MS.". 

de. Procedure names begin with the four characters "MC5.". 
ee. DO-groun Labels being with the three characters "ML.™. 


MESS procedures not only have access to entities declared in the 

global section but also to many data areas and procedures within the 
standard MCS. The most important of these is the message area 
MS.MSG.~TEXT. Other interfaces can be determined by examining generated 
source code. 


MESS procedures require very few» if any» input parameters. Some must 
create an output oarameter to inform the MCS about the results of 
executing that MESS procedure. 


The programmer of MESS code 1s responsible for segmenting procedures. 
Some efficiency in memory atlocation may be realized 1f MESS segments 
are each approximately 1500 bytes Larges which is the size of other 
MCS routines. 


Following are discussions of each of the MESS routines. 


MESS.~SET.SIZES. 

This procedure is given controt during the first phase of the initial- 
ization logic in the MCS. Its purpose 1s to specify sizes for any MESS 
data items which are declared as DYNAMIC. 


For examples» suppose that the following declaration statement appears 
in the procedure section of MESS: 


DECLARE DYNAMIC USER-AREA CHARACTERCMAX.SIZE)D3 


Then» the MESS.SET.SIZES routine must be provided. It might look like 
this: | 


PROCEDURE MESS.SET.SIZES» 
MAXeSIZE 2= 1005 
END MESS.SET.SIZES> 


MESS.SET.SIZES 1s called only by the MCS.INITIATE.SIZES routine 
Cnumber 182). 


MESS.SET.VALUES. 

This procedure is given control during the second phase of MCS initial- 
ization. Its purpose is to assign initial values to any global data 
items in the MESS code Ceither in the global section or DYNAMIC items 
in the procedure section). It cannot be used to initialize items 
declared locatly within individual MESS procedures. 


For examples suppose that the following declarations appear in the 
global section of MESS: 


DECLARE 
XeCOUNT BITC(10)>» 
Ye-COUNT BITC10)> 
Z-COUNT BITC(10)5 


These items might be initialized thus: 


PROCEDURE MESS.~SET.~VALUES>» 
X-COUNT := QO» 


Y-COUNT := O-8 
Ze.COUNT 2= QO» 
END MESS.~SET.VALUESs 


MESS.SET.~VALUES 15 catied only by the MCS.INITIALIZE.~TABLES routine 
(number 158). 


MESS.~MSG.eFROM.STATION.. 
This procedure is given control when: 


ae The MCS receives a message from a station. 
be. The message passes security logic. 
ce The message 1s not a Network Controt Command. 


At the time it gains controls, the SID header (if SID = TRUE) 1s already 
built but not yet inserted into MS.~MSG.~TEXTs’ howevers SID information 
is available in the fietds: 


MS.SIO.LSN 
MS.SID.MCS.TYPE 
MS.SID.SEQ.NO 
MS.SID.NDL.TIME 
MS.SID.TEXT.SIZE 
MS.SIO.TERM.TYPE 


Ordinarily» MESS.~MSG.~FROM.STATION 15 used to change the format of 
messages by (for example) insertings deleting» or rearranging infor 
mation. It can also be used to implement paging.» If the text size is 
changeds then the fields MS.SID.TEXT.SIZE Cif SID = TRUE) and MS.MSG. 
TEXT.~SIZE must be updated. 


MESS.~MSGeFROM.STATION must be a function procedure which returns a 
i-bit value specifying disposition of the message: 


ae A value of 0O (zero) telts the MCS to continue processing the 
message normally. | 


be. A value of 1 means that MESS.~MSG.FROM.STATION has completely 
processed this message. The MCS will then exit immediately 
to the main control procedure and not do any more processing 
of this message. 


This routine is called only by MCS.MSG.FROM.STATION (number 332). 


MESS.MSGeFROM.~PROGRAM. 

This procedure is given control when the MCS receives from a program 
a message which is not an NCC. At the time it gains control the SID 
Cif SID = TRUE) is already removed from MS.MSG.TEXT? howevers SID 
information is still available in the fields: 


MS.SID.LSN 
MS.SIDeMCS.TYPE 
MS.SID.SEQ.NO 
MS.SID.NOL.TIME 
MS.SID.TEXT.SIZE 
MS.SID.TERM.TYPE 


Ordinarily» MESS.~MSGeFROM.PROGRAM is used to change the format of mes= 
sages by (for example) insertings deleting» or rearranging data. It 
can also be used to implement paging. If the text size 1s changed» 
then the field MS.~MSG.TEXT.~SIZE must be updated. 


MESS»MSGeFROM.PROGRAM must be a function procedure which returns a 
l-bit value specifying the disposition of the message: 


ae A value of 0 (zero) tells the MCS to continue processing the 
message normally. 


be. A value of 1 means that MESS.MSG.FROM.PROGRAM has completely 
processed this messagee The MCS will then exit immediately 
to the main control procedure and not do any more processing 
of this message. 


This routine is called onty by MCS.MSG.FROM.USER.PROGRAM Cnumber 331). 


MESS»MAINTENANCE. 

The purpose of this procedure is to process any user-defined Networx 
Control Commands. Its function varies depending on whether the stand- 
ard maintenance module is present. The standard maintenance module 1s 
generated if and only if at least one of the following generation 
parameters 1s TRUE: 


ae CHANGE“REQ. 
be OATA~OUMP. 
ce MSG-8RDCST. 


de MSG“RECALL 

e. PGM-BOJ-EDJ. 

f. STATUS“REP. 

ge SYS“HALT. 

h. TABLE-OUMP. 

ie ACCESS-SECURITY. 
je RESTORATION. 

ke. MONITOR. 


When the standard maintenance module is presents MESS.MAINTENANCE ts 
called before the message 1s scanned for any standard commands. There- 
fores WHESSe.MAINTENANCE can ignore any messages it doesn't recognize. 

If the standard maintenance module is not presents» MESS~MAINTENANCE 
must handle all messages presented to it and must take appropriate 
action for invatid messages. 


The only messages presented to this routine are those which have as 
their first character a signal character as declared in NOL. If access 
security logic 1s inctuded» then it processes the sign=on command SGN 
when a user may validly request signing on: however» if the SGN com- 
mand 1s entered when the station 1s already stgned on or does not 
require signing ons then the message is forwarded to the standard 
maintenance logic for error handling. 


MESS.~MAINTENANCE must be a function procedure which returns a 1-bit 
value specifying the disposition of the message: 


ae A value of O Czero) means MESS.«MAINTENANCE did not process 
the message. | 


be. <A value of 1 means MESS.~MAINTENANCE has processed the message 
completely. 7 


MESS.~MAINTENANCE must accept one Inout parameter: the number (FIXED) 
of the calling procedure. It is called by the primary maintenance 
procedure MCS.MAINT.CONTROLLER when standard maintenance logic is 
included» otherwise it 18 called by either MCS.MSG.FROM.STATION or 
MCS.MSG.FROM.USER.~PROGRAM. 


MESS.AUDIT. | 

This procedure can either supplement or replace the standard auditing 
Logic. It is called after the standard audit procedure (if generated) 
is executed. Any files needed by MESS.AUDIT must be declared in the 
global section of MESS code. 


MESS.-AUDIT must accept two parameters: 
ae The number (FIXED) of the calling procedure. 


be A number (FIXED) which denotes the type of message being sent 
from the MCS: 


1) A value of 0 (zero) means the message 1s bound for a 
station. 


2) A value of 1 means the message is bound for a program. 


3) Other values denote special communications between the 
MCS and the NC. 


MESS.~ERROR.HANDLER. 

The primary function of this procedure 1s to supplement the standard 
error handling module of the MCS. As a secondary function 1s may also 
save the contents of MS.~.MSG.~WORK.AREA in case of a data dump. For 
certain system errors» a data dump 1s created. fhe standard error 
handling logic tnduces the dump by synthesizing an RDM Network Control 
Command in MS.MSG.WORK.AREA. The message that was stored in 
MS.MSG.WORK.AREA when the error was detected is therefore lost» unless 
MESS~ERROR.HANDLER saves ite 


This procedure must accept one parameter: the error message number 
CCHARACTER(C2)) which corresponds to the error detected. 


MESS-ERROR.HANDLER must be a function procedure that returns a value 
(BITC1)) which tells the MCS what to do with the error condition: 


ae A value of 0 (zero) means that the error should be processed 
normally. 


be. <A value of 1 means that the MCS is to exit the error handling 
module immediately. | 


MESS.~ERROR.HANDOLER is called only by MCS.PRINT.ERROR (number 640). 


MESS.~CLOSE.~FILES. 

This procedure is given control during system shut down (EOJ?). Its 
primary purpose is to close any files that may have been opened in 
other MESS routines. 


MESS.CLOSE.~FILES 1s catted onty by the MCS.EOJ procedure (number 858). 
It is not called at all unless the generation parameter SYS“HALT is set. 


MESS»HANDLE.RECALL. 

This procedure is given control during system shutdown (EQJ). At this 
times the MCS recatts alt messages which have been routed to a station 
but are still awaiting transmission in the queues of the Network Con- 
troller. MESS.HANDLE.~RECALL is invoked each time a message arrives 
back at the MCS. | 


MESS-HANDLE-RECALL must be a function orocedure which returns a value 
(BIT(1)) specifying disposition of the message: 


ae A value of O (zero) causes the MCS to print the message on a 
Line printer before discarding it. 


De A value of 1 causes the MCS to discard the message without 
further processing. 


If this procedure is not provideds the MCS prints alt recalled messages 
before discarding them. 


This procedure is called only by MCS.EOJ (number 858). It is not 
called at all unless the generation parameter SYS-HALT 1s set. 


MESSe-INITIATE.~RESTORE. 

This procedure is given control when an application program indicates 
to the MCS that it needs restoration (by sending a message which has 
the message type field set to 1). It may either supplement or replace 
the standard restoration initialization module (depending on the gen- 
eration parameter RESTORATION). Its purpose 1s to perform any 
Initialization that may be necessary to get ready for restoration. 


This procedure is catted only by MCS.MSG.FROM.USER.PROGRAM (number 331). 


MESS.~RESTORE.jPROGRAM. 

This routine is intended to replace the standard restoration logic 

of the MCS. It is catled from the main processing loop in MCS.MODULE. 
MANAGER (number 323). It is called once in each iteration of the loop 
as long as the flag MS.RESTORE.~PROGGRAM has a vaiue of 1. It if is nec= 
essary to handle other network activity during restorations MESS. 
RESTORE.~PROGRAM must relinquish control (Ci.e.» RETURN) occasionally s 
that the matin processing loop can run through another cycle. | 


MONITOR. 


To aid in monitorings each routine in the MCS is assigned a 3-digit 
number. The first of the three digits is a code indicating to what 
module the procedure belongs. The module number 0 (zero) 18s reserved 
for MESS procedures. The last two digits identify the procedure. 
Numbers 90 thru 99 may be assigned to MESS procedures by the MESS 
programmer. 


Corresponding to the tast two digits of the procedure number are 99 
monitor flags. <A given procedure is monitored onty if the MCS was gen- 
erated with the MONITOR parameter set and the corresponding monitor 
flag has a value of 1.2 There are two ways to change the settings of 
monitor flags: | 


ae When the MCS 1s runnings by entering a CMF (change monitor 
flag) NCC. 


be When the MCS 1s not runnings by executing MCSFIT with an NPR 
card as input. 


If a procedure is to be monitored» it must contain at least one call on 
the monitor procedure. The monitor 1s invoked by a UPL statement of 
the form: 


MD-MONITORC nl» sls» n2sx s2)3 
The parameters for MD.~.MONITOR are explained betow: 


ae Parameter nil is the number of the procedure that called the 
current procedure. 


b. Parameter sl is a string of up to 30 characters that describes 
the current procedure. 


ce Parameter n2 is the number of the current procedure. 


d.- Parameter s2 is a string of up to 91 characters which contains 
any information that may be useful for debugging (usually the 
names and contents of significant data items). 


Each time MD.~MONITOR 18s invoked Cand the corresponding monitor flag 1s 
1) these parameters are orinted in order on one line of the monitor 
Listing. 


Monitor calls are ordinarily the first executable statement of each 
routines however» they can be placed anywhere that is useful for 
debugging. 


MCQELTLs 


MCSFIT 18 the name of the program used to create and maintain the 
MCSTIC file. MCSFIT 1s created by the Generator program when the pa- 
rameter MAKE-MCSFIT is set. The same basic set of parameters should be 
used to generate MCSFIT as are used for generating the MCS so that both 
programs have a common description of shared data. 


MCSFIT accepts instructions in the form of a card deck. In addition to 
operating on the MCSTIC files it also creates a printer Listing which 
Summarizes the input cards. Refer to table 3-9 for the card layouts. 


Table 3-9 


MCSTIC Card Layouts 


a 


- NEW Create a new MCSTIC file. 
NPR 1-3 NPR Change network parameters. 
4 0 Change a flag other than one of the 


monitor flags. 
1 Change one of the monitor flags. 
is 0 
Change the restoration flag. 
Change the simulation flag. 


is 1 


4 
| 
000 Change all nonitor flags. 
nnn Change the monitor flag specified by the 
Integer "™nnn” Cbhetween 001 and 099> 
inclusive). | 
8 0 Reset the specified flag or flags. 
1 Set the specified flag or flags. 
WSR 1-3 USR Define user security. 
4-7 XX XX User identification code. 
B-13 XXX XX Password. 
14°15 nn Security level tower bound. 
16717 nn Security level upper ends 
18 Y Enable user. 
N Disable user. 
19 Y User 1S a network manager. 
N User is not a network manager. 
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Table 3-9 (cont) 


MCSTIC Card Layouts 


Define station security. 


LSN of station for which signing on not 
required. 


Security level lower bound. 


Security level upper bound. 


Each card type is further explained below: 


ae NEW. This card is used to create the first MCSTIC file or,» if 
necessary», to re=create one. It causes a new file to be 
opened and the first nine records to be initialized. If a NEW 
card is presents» it must be the first card in the deck» and 
NPR cards are not permitted. 


b. NPR. Network restoration happens automatically unless the 
restoration flag 1s reset. Resetting the flag has effect only 
on the next execution of the MCS» after which the flag is set 
again. The simulation flag must be set if the auxiliary pro- 
gram MCSSIM it to be used to simulate network activity. The 
number of a monitor flag is determined by the Last two digits 
of the number of the procedure to be monitored.j NPR cards are 
not permitted when a NEW card is present in the itnput deck. 


ce USR. These cards are necessary only if the ACCESS-SECURITY 
generation parameter is set. 


de STR.~ These cards are needed only if the security features of 
the MCS are being used and there are stations which do not 
require signing one. When orocess security is not being used» 
the upper and tower security level bounds may be omitted. If 
the deck begins with a NEW cards STR cards must appear in 
asceftiding order by LSN. 


NETWORK_CONTROL COMMANDS: 


Network Control Commands. (NCCts) consist af a signal characters a 
short mnemonic command codes and» in some cases» one or more parameters. 
Commands are free in forms with words separated by one or more spaces. 
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Every Network Control Command generates some kind of response. There 
are three kinds of responses? 


ae 


b. 


Confirmation without data. This response is specified by the 
user through the generation parameter NCC-OK~RESPONSE. 


Confirmation with data. For NCC*s which request that data be 
returneds the data itself serves as confirmation that the 
command was executed. 


Rejection. If a command was not successfully executed» a 
message is returned giving the reason. 


In defining the syntax of NCC*ss the following conventions are used: 


as 


be 


De 


Atl underlined uppercase words are key words and are required 
when the functions of which they are a part are utilized. 


Uppercase words which are not underlined are optional and may 
or may not appear in the message. 


lowercase words are generic terms which must be supplied by 
the user. 


When words or phrases are enclosed in brackets (€1]) they may 
be included or omitted at the user's choice. When words or 
phrases are enclosed in braces ({}) a choice of one of the 
entries must be made. In both caseSs a choice 1s indicated by 
vertically stacking the possibilities. When brackets or 
braces enclose a portion of syntax» but only one possibility 
is showns the function of the brackets or braces is to delimit 
that portion of the syntax to which a following ellipsis 
applies. 


The ellipsis (...) represents the position at which repetition 
may occur. Repetition 1s optional. The portion of syntax to 
be repeated is that which is enclosed within the logically 
matching pair of brackets or braces whose righthand member 
immediately precedes the ellipsis. 


The coton character (:) is required when it appears in the 
Syntax» even though it 1s not underlined. 


The asterisk (*) is used to denote the location of a signal 
character. The actual character used in place of the asterisk 
must be a signal character as specified in NOL. 


The term “statton-specifier”™ is to be replaced by either of 


the following: 


1) The atphanumeric station identifier assigned to the. 
station in the station section of NDL. 


2) A number which specifies the position that the station 
definition occupies in the station section of NOL. (The 
first station defined is 1% the second station defined is 
253 and so one) This number ts also known as the logical 

station number (LSN). 


The term "lLine=specifier™ is to be replaced by either of the 
following: 


1) The alphanumeric Line identifier assigned to the line in 
the line section of NOL. | 


2) A number which specifies the position that the Line 
definition occupies in the line section of NOL. 


SECURITY CONTROL COMMANDS. 


These commands can be used only if the ACCESS“SECURITY generation pa- 
rameter 1s set and USR cards have been used to toad user-[D"s and 
passwords into the MCSTIC file. 


SIGN ON (SGN). The SGN command is used to gain access to the system at 
a station which requires signing on. 


SYNTAX: 
* SGN user-id password 


Example: 
a SGN ABCD PASWRD 


Comments: 


User ABCD is signed on if PASWRD 1s the correct password. 


SIGN OFF (BYE). The BYE command disconnects a signed=on user from a 
Station. After auser has completed his transactions» he should sign 


off to ensure that no unauthorized person 


is able to gain access to the 


system. BYE can not be entered from a station which does not require 


signing on. 
SYNTAX: 


* BYE 


The EUS command 
with 


ENABLE USER CEUS?). 
enabled. The enabled user-ID>» 
used to sign on. 
SYNTAX: 
*« FUS user-id 
Examole: 
a EUS ABCD 


Comments: 


User ABCD may sign on. 


is used to mark a userID as 


EUS 


the correct passwords can then be 


DISABLE USER (DUS). The DUS command 1s used 
being used for logging on. 


SYNTAX: 

* DUS user-id 
Examole: 

a OUS ABCO 
Comments: 


User ABCD is no longer able to sign 
1s enabled again. 


to prevent a user-ID from 


on until the user-ID 


Es 


PROGRAM CONTROL COMMANDS. 


These commands can be used only if the generation parameter 
PGM-BOJ-E0J 15 set. 


EXECUTE PROGRAM CEX). The EX command is used to start application pro- 
gramse Confirmation of this command merely means the MCS communicated 
"ZIP EXECUTE" to the MCPs it does not guarantee that the program 
actually started. 
SYNTAX: 
* EX program-name (Ccharge-number ] 


Examoles: 


a EX PROG/A 
a EX PROG/C 12345 
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HALT APPLICATION PROGRAM CHAP).j The HAP command is used to cause an 
End-of-File condition on the remote file that a program has open. 


SYNTAX: 
* HAP program-name 
Example: 


2 HAP PROG/A 


3-30 


MCS CONTROL COMMANDS. 


AUDIT OK CAQK). The AOK command is used in response to a message on 
the console printer of the form: 


BACKUP AUDIT REQUIRED: DATE mmddyy SEQ.NOw xxxxxx 
It informs the MCS that the requested audit file is available on disks 
and that its name has been changed to "*MCSAUD". This command can be 


entered only at the console printer through the MCSOLI program. 


SYNTAX: 


* AQK 


HALT SYSTEM CHLT). The HLT command brings the data communications sys- 
tem to a stop. This command can be used only if the generation 


parameter SYS“HLT 1s sete 
SYNTAX: 
* HELI KILL 


SEMANTICS: 


If KILL is not specified the system comes to an orderly stops 
and untransmitted messages are recalled. If KILL 1s spec- 


ified» the system comes to an abrupt stop» and messages may 
be lost. 


MESSAGE CONTROL COMMANDS. 


BROADCAST (3RC). The BRC command is used to send a message to other 
stations in the network. It is available only if the generation 
parameter MSG-BRDCST is set. 


SYNTAX: 
station=specifier 
* BRC ae* ° message-text 
| Seo 
SEMANTICS: 


More than one “station-specifier” may be entereds in which 
case the message 1s sent to each station. If no “station= 
specifier™ is entered» the message 1s sent to all stations in 
the network. If SPO is entered» the message is sent to the 
console printer. 


Examoles: 


a BRC2GO0D MORNING 
a BRC 3 TD4:WHAT*®S HAPPENING? 
a BRC SPO:PLEASE LOAD PROGRAM BLACK/JACK 


POP QUEUE (PQ). The PQ command is used to recall messages from the. 
output queue of a station. This command can only be used if the 
generation parameter MSG-RECALL 185 set. 


SYNTAX: 


station-specifier“1 ALL PRINI 
x PQ | 
Lline-specifier LINE 


SEMANTICS: 


If “ALL” is not entered» only the oldest message is recalled. 


If "ALL™ is entered» then all messages in the queue are re- 
called in orders» with the oldest one first. If “tline- 


specifier LINE™ is entered» all messages queued for that line 


are retrieved. If neither "*PRINT™ nor "SEND®* is specified» 
recalled messages are discarded. “PRINT™ causes recalled 
messages to be printed on a system printer. “™SEND™ causes 
recalled messages$ to be sent to the indicated station. 


Examole: 
a PQ 5 
Comments: 


One message from the queue for station 5 1s retrieved and 
discarded. | 


Examole: 
a PQ 3 ALL PRINT 


Comments: 


ALl messages for station 3 are recalled and printed. 
Examole: 

a PQ 1 LINE 
Comments: 

All messages for line 1 are recalled ani discarded. 
Examole: 

a PQ@ T01 SEND TO2 
Comments: 


One message for TDi is sent to TD2 instead. 


SENQ station-specifier~2 


REPORT COMMANDS. 


With the exception of RDM» which is controlled by the generation 
parameter DATA~DUMPs the existence of these commands is controlled by 
the generation parameter STATUS“REP. | 


When examining error statistics it should be kept in mind that: 


ae 


b. 


Counters start at zero each time the MCS 1s executed. 


The MCS increments a counter by the retry Limit when the NC 
reports an error to the MCS» but the NC reports an error only 
when the retry timit is exceeded. Thus» the number of errors 


reported tin the response to the NCC may be slightly less than 
the number that actually occurred. 


REPORT DATA DUMP CRDM). The RDM command allows access to the contents 
of MCS data fields. 


SYNTAX: 
* RDM PRINT 

SEMANTICS: 
When "PRINT" is specified» the report is sent to a system 
printer and the contents of MCS tables are included. When 
“PRINT™ ts not entered» only nonetable information is in- 


cluded. Other report commands are available for displaying 
table information at a remote station. : 


REPORT FILE STATUS CRFS).j The RFS command returns the following 


information about a remote file: 
ae Whether the file is open. 
be Open attributes. 


Cc. Program queue number. 
de Stations comprising the file. 


SYNTAX: 
* RES Cfile-namej 
SEMANTICS: 


If "*file-name™ is not entered, 
is returned. 


Exapoles 
a RFS REMOT1 


the 


status of all remote files 


RLC 


REPORT LINE COUNTERS CRLC). The RLC command is used to obtain the 
following statistics about a Line: 


ae Number of input messages. 
be. Number of output messages. 
c. Number of line errors. 


SYNTAX: 
*« RLCE Cline-specifier] 
SEMANTICS: 


If a *lLine=specifier” is not entered» 
for ail lines. 


Exanoles: 


@ RLC LINEX 
a RLC 4 


statistics are reported 


REPORT LINE STATUS CRLS). The RLS command returns the following 
information about a Line: 


ae Whether the Line is ready. 
b.» Whether a change 1s in progress on the line. 
Ce Location (ports channel» and adapter number). 


SYNTAX: 
* RLS (ClLine-specifier] 


SEMANTICS: 


If a *ltine-specifier" is not entereds status is reported for 
alt lines. 


Examole: 


@ RLS 1 
@ RLS LINEA 


REPORT PROGRAM STATUS CRPS). 


information about a program: 


The RPS command returns the fotlowing 


status of all active 


ae The number of messages received. 
be The number of messages sent. 
ce The names of remote files the program has open. 
d.- The number of the associated queue. 
SYNTAX: 
* RES Cprogram-name] 
SEMANTICS: 
If "“program=-name* is not entered» the 
programs is reported. 
Exageles 


a RPS PROG/A 


REPORT STATION COUNTERS CRSC). The RSC command returns the 


statistics about a 


ae Number of 
be. Number of 
ce Number of 
de Number of 
e. Number of 
SYNTAX: 


station: 


messages sent. 

messages received. 

data communications errors. 
NCC's affecting the station. 
changes made. 


station-specifier 
* ROC 
line-specifier LINE 


SEMANTICS: 


following 


If no “station=specifier™ or “™Line-specifier” is provided», 


statistics are reported for all stations. 


LINE" 1s entered» then statistics are reported for att 


stations on that Line. 


Examoles: 


@ RSC TOl 


@ RSC 1 LINE 


If "*line-specifier 


REPORT STATION STATUS CRSS) The RSS command reports the following 
about a station: | : 


ae Whether the station is ready and enabled. 
be Usage Cinput» outputs or both). 


Cs Retry count. 
de Line to which the station is attached. 


SYNTAX: 
station-specifier | 
« Ro 
line-specifier LINE 


SEMANTICS: 


If no *station=specifier™ or “*lLine-specifier™ is provided» 
status is reported for all stations. If “*line-specifier 
LINE” is entered» then status is reported for all stations. 


Examoles: 


a RSS TD1 
a RSS 1 LINE 


=A 


REPORT TERMINAL STATUS CRTS). The 
type and buffer size. 


SYNTAX: 
*« RIS Cterminal-name] 
SEMANTICS: 


If "terminal*name™ is not 
terminals. 


Examole: 
aRTS TO700 


RTS command returns the terminal 


entered» 


status 


is reported for all 


CHANGE COMMANDS. | ee ee ee 
With the exception of CMF» which ts controlled by MONITOR» and CRV> 


which ts controlled by TABLE-DUMP» the existence of these commands 
controlled by the generation parameter’ CHANGE“REQ. 


is 


CHANGE LINE LOCATION CCLL). The CLL command is used to change the 
ports» channel» and adapter specifications of a line. | 


SYNTAX? 


* CLL line-specifier port-number channel-number adapter-number 
Examole: 
actt L1 7 2 0 


Comments: 


Line Li 1s now located at port 7» channel 2» adapter 0. 


CHANGE LINE READY (CLR). This command is used to mark a tine as ready 


or not ready. 
SYNTAX: 


R 
* CLR line-specifier 
N 


SEMANTICS: 
"R" makes the line readys “N"™ makes it not ready. 
Exapoles: 


aCLR 1 R 


CHANGE MONITOR FLAG CCMF). The CMF command 1s used to enable or 
disable monitoring of procedures in the MCS. , | 


SYNTAX? 


») 
* CME cAagenunberdene? | 
N 


SEMANTICS: 
A “flag-number”™ 1s the last two digits of a procedure number. 
More than one *flag-number™ may be entered. If no "flag= 
number™ is entereds all monitor flags are changed. “N" Cnor- 


mal) sets the monitor flag{€s) to 0 Czero)s "0D" (Cdiagnositc) 
sets the monitor flag(€s) to 1. 


Examoles 
a CMF 13:0 
Comments: 


Procedures which have "13" as the last two digits will be 
monitored. 


Examole: 
a CMF 3N 
Comments. 


No procedures are monitored. 


CHANGE REPORT VARIABLE CCRV).} The CRV command is used to change the 
interval between periodic dumps of MCS data. 


SYNTAX: 
*« CRV time~interval 
SEMANTICS: 
The “*time-interval™ is the number of minutes between dumps. 


Examoles: 
a CRV 60 


Comments: 


The report will be generated every hour. 
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CHANGE STATION ADDRESS (CSA). The CSA command 
a new togical address for a station. 
SYNTAX: 


I 
* CSA statiton-speci fier address 
Q 


SEMANTICS: 


1s used to give the NC 


The codes "I" or “O" tell whether the new address applies on 


input or output. 
Examole: 

a.CSA 5 0 1A 
Comments: 


Station 5 will have an output address 


of "1A". 


CHANGE STATION DOIAGNOSTIC (CSD). The CSD command its used to tell the 
NC whether to use normal of diagnostic request logic (Cas defined in 
NDL) for a station. 


SYNTAX: 


N 
* €S0 station-specifier 
Q 
SEMANTICS: 


The code *"N* selects normal request tlogics “D"™ selects 
diagnostic logic. 


Examole: 
acsD 2D 
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CHANGE STATION ENABLE (CSE). The CSE command is used to enable or. 
disable input from a station. | | 


SYNTAX: 


E 
* CQE station-speci fier 
u 


SEMANTICS: 

The "E™ stands for "enabled*s "N"™ for "not enabled.” 
Examale: 

a CSE TO2 N 


eee 


CSF 


CHANGE STATION FREQUENCY (CSF). The CSF command is used to assign a 
new input or output frequency (Cpriority) to a station. 


SYNTAX: 


I 


* CSE station-specifier 
Q 


frequency 


SEMANTICS? 
The codes “I* and "0" specify whether the frequency applies 


on input or output. "Frequency™ must be an integer less 
than or equal to 255. 


Examales: 
acsF Td2 I 250 


CHANGE STATION MAX=RETRY (CSM). The CSM command is used to give a 


new value to the number of times the NC tries to retransmit a message 
when there are errors. 


SYNTAX: 


* CSM station-specifier retries 


SEMANTICS: 


"Retries™ must be an integer up to two digits long. 


Examole: 


ad CSM 1 16 


CHANGE STATION QUEVE (CSQ). The CSQ command is used to reroute 
messages bound for one station to some other station instead. 


SYNTAX: 
*« €5Q station=specifier-1 station=specifier=2 
SEMANTICS: 
—"Station=specifier-1" is the original stations and “station- 
specifier-2" is the new station. If "“"station-specifier-1" and 


*"station-specifier-2" are the sames routing reverts to the 
original station. 


Examale: 
@ CSQ TO1 TD4 
Comments: 


Messages which would ordinarily go to station TO1 will now go 
to station TD4. 


CHANGE STATION READY CCSR). 
as “ready” or “not ready.* 
Station that is not ready. 


SYNTAX? 


R 
* (SR station-specifier 


Examoles: 


a@ CSR 3 R 


The CSR command 


1s used to mark a station 


The NC does not attempt to do any I/0 on a 


N 


CHANGE STATION TRANSMISSION NUMBER (CST).}j The CST command is used to 
give a new value to the transmission number of a station. 


SYNTAX: 
I 


* CsI station-specifier 
| 0 


transmisston*number 


SEMANTICS: 


The codes "I" and "0" tell whether the input or output 
transmission number is to be changed. 


Examole: 
acsTt TO1 1 35 


SECTION 4 


SYSTEM OPERATION 


GENERATING_AN_MCS. 


The following steps must be taken to generate an MCS: 
ae Load the following files from the GEMCOS release package: 


1) MCSGO. (C(MCSGO requires the COBOL interpreter). 
2) MCSGTS. 
3) MCSFTS Cif the generation parameter MAKE-MCSFIT is set). 


be. Enter a card deck of the following format through a card 
reader. (For 80-column card readers» the question mark must 
be replaced by any punch configuration nae iS not a valid 
EBCDIC code): 


? EX MCSGO 

2? DATA MCSCRD 

(Parameter assignment statements.) 
hexe EXIT. 

Z*«* LABEL MESS~“GLOBAL-SECTION. 
(MESS global section. ) 

Awkuxkx EXIT. 

~A**x*x LABEL MESS“PROCEDURE*SECTION. 
(MESS procedure section.) 

ZAxxe EXIT. 

? END 


If the MESS gtobaltl section or MESS procedure section is 
omitted» the preceding LABEL statement and following EXIT 
Statement may be omitted. The EXIT statement following the 
parameter assignment statements is always required. The 
card file used to generate a default MCS would only contain 
a single EXIT statement. 


ce The Generator MCSGO Leaves a file MCSTMP on disk after it 
finishes executing. This file merely contains a copy of the 
input card deck and may be removed. If» during executions a 
duplicate file condition occurs for one of the disk files used 
by the Generators» enter the following on the console keyboard: 


mix RM 


At the end of generations the file MCSSRC and the file MCSFIT Cif MAKE- 
MCSFIT is set) will be on disk. These are UPL source code files. If 
either of the generation parameters COMPILE=MCSSRC or COMPILE=-MCSFIT is 
Set» compilation starts immediately» otherwise it must be started 
manually. 


If any errors are detected during generations the Generator displays 

a message on the console printer and creates an error listing on the 
printer file MCSERR. These errors must be corrected and the generation 
process repeated from step b. 
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See figure 4-1 for a diagram of the generation flow. 
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Figure 4°71. Generation Flow 


EXECUTING _ AN_MCSe2 | | 

Before the MCS is executeds the MCSTIC file must be initialized. This 
is done with the MCSFIT program using a NEW card. Once MCSTIC is 
initialized» the MCS can be executed repeatedly. If it becomes neces- 
sary to update or re-create MCSTIC» MCSFIT may be executed again 
anytime the MCS is not executing. 


To execute MCSFIT» enter a card deck in the following format through a 
card reader: 


2? EX MCSFIT 

? DATA MCSFMD 

C(NEW» NPR» USER» and/or STR cards.) 
? END 


To start the data communications systems these programs may be executed 
In any order: 


ae The MCS. 
be. The Network Controller. 
ce Application programs. 


The auxiliary program MCSOLI 1s provided to allow the system operator 
to communicate with the MCS via Network Control Commands. 


RECOVERY PROCEDURE. 
A GEMCOS MCS which has auditing logic writes audit records into a disk 


file. This disk audit file is closed: 


ae When it becomes filled. 
be At EQJ. 


A new audit file is created: 


ae After the previous one is filled. 
be At BOJ. 


The ID of the audit file is "MCSAUDIT/MCSADn"™» where *n* is a number in 
the range 0 thru 9 and ts incremented (modulo 9) for each new audit 
file. | 


When the MCS first opens an audit files» it displays a message of the 
following form on the console printer: 


AUDIT FILE n OPEN =: DATE mmddyy SEQ. NO. ssssss 
where "n® is the last character of the file name> emmddyy* is the 
month» days and year in which the file is created» and “"“ssssss* is the 


sequence number of the first message in the file. When an audit file 
is filled» the following message is displayed: 


AUDIT FILE n FULL = SEQ. NO. RANGE ssssss ~ tttttt 
where “ssssss™ and “tttttt"™ define the range of sequence numbers con- 


tained in the file. The date and sequence number range are used to 
identify audit files when needed for restoration. 
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When the MCS needs an audit file for restoration (other than the audit 
file it is currently creating)» it displays the message: 


BACKUP AUDIT FILE REQUIRED =: DATE mmddyy SEQ. NO. uuuuuu 


where “mmddyy” and “*uuuuuu™ are the date and sequence number given to. 
the MCS by the application program when it requests restoration. If 
the file created on this date and containing this sequence number is 
not already on disks the operator must load ite. If a subsequent backup 
audit file is needed the MCS displays: 


NEXT SUCCESSIVE BACKUP AUDIT FILE REQUIRED = SEQ. NO. vvvvvv 


In either cases the name of the backup audit file must be changed from 
"MCSAUDIT/MCSADn™ to “"MCSAUD*. 


While the MCS waits for the backup audit file» it continues to service 
the network. The operator informs the MCS that the requested backup 
audit file is available by entering the AOK Network Control Command at 
the console keyboard via the auxiltary program MCSOLI. 


During restoration the MCS continues to process messages for programs 

that are not being restored. If the MCS receives a message which Is 

destined for a program that is being restored» 1t sends a message to 

the originating station saying that restoration 1s in progress and 
that the input message was ignored. 


NOTE 
If no messages are being put into the 
system» restoration is suspended. 


In order to continue to service the network during restorations the 
MCS periodically reads from its input queue. If there are no messages 
in the queues the MCS is suspended. This condition is Likely to occur 
after a Clear/Start when all programs need restoration. The problem 
can be circumvented by using the card input feature of MCSOLI to feed 
dummy messages into the system. 


SECTION 5 


AUXILIARY PROGRAMS 


MCQOLIs 


The program MCSOLI allows Network Control Commands to be entered 
through the console keyboard or through a card reader. Input can be 
switched from console keyboard to card reader and back. 


The format of NCC*s is the same as when they are entered from a remote 
station. 


To run MCSOLI,s follow these steps: 


ae Execute MCSOLI through etther the console keyboard or a card 
reader. 


b. MCSOLI tries to open a card file labeled MCSOLICRD. At this 
point there are two possibilities: 


1) If NCC*s are to be entered via cards» place a card deck of 
the following format in the card reader: 


? DATA MCSOLICRO 
(Network Control Commands) 
? END 
When MCSOLI reads the ? END cards» it proceeds to step c. 


2) If cards are not to be used» then either use the card deck 
described in step 1)» but without any NCC cards» or enter 


mix OF 


through the console keyboard in response to the MCP 
messages: 


MCSOLI = mix FILE MCSOLI.CAR LABELED 
"MCSOLICRO™ NOT PRESENT. 


Ce The message: 
ENTER NETWORK CONTROL COMMAND 
is displayed on the console printers followed by: 


MCSOLI = mix ACCEPT. 


ae, 


There are three possible responses: 
1) Enter an NCC: 
mix AXnetwork-control-command 


MCSOLI accepts the command and returns to the beginning of 
step c. 


2) Revert to card input: 
mix AXCARDS 
MCSOLI proceeds to step b. 
3) Terminate MCSOLI: 
mix AXEND 


Input may be switched from cards to console as many times as necessary. 
Both card and console input generate responses on the console printer. 
Card input is tisted on a tine printer. 


MCoQTMe 

The program MCSSIM makes it possible to test an MCS and MESS code with- 
out using the NC or any remote stations. Input messages are simulated 
via acard reader. OQutputs are listed on a printer. 


INPUTS. 

The first two cards of the input deck describe the size and configur- 
ation of the network to be simulated. They must always be present and 
must always appear itn the same order Refer to tables 5-1 and 5-2 for 
the layout of these cards. 7 | 


Table 5-1 


Network Size Card Layout 


Card ID "NS*. 
Maximum number of terminals. 

Maximum number of stations. 

Maximum number of lines. 

Maximum number of files. 

Maximum number of stations per line. 
Maximum number of stations per file. 
Signal character. 


Table 5-2 


Station Status Card Layout 


CARD ID "™SS*. 
Number of stattons on line 1. 
Number of stations on line 2. 
Number of stations 


stations 


Number of 


The total number of stations specified on the SS card should equat the 
maximum number of stations specified on the NS card. 


The rest of the input deck simulates messages for the MCS from a sta- 
tion» from a programs or from the NC. Each input message is divided 
between two cardss a header card and atext card. The text is limited 
to 80 characters. Every header card must be followed by a text card 
even though the text card may be blank. If this sequence is broken>, 
results are unpredictable. Formats of the various header cards are 
presented in table 573. 


Table 5-3 


Header Card Layouts 


0 1 0 Message from application program. 


5-6 nn Queue number of file to which 
station 1s attached. 


8-10 nnn LSN of destination station. 
1 | 1 1 | Message from station. 
3 Message variant. 
0 Good input. 
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Table 5-3 (cont) 


Header Card Layouts 


Exception condition. 


Queue number of file to which 
station is attached. 


LSN of station. 


File open notification. 


Maximum stations. 


Open type. 


Invalid. 
Input. 
Output. 
Input/Output. 


Job number. 


Current stations. 


File name. 


Queue number of file. 


File close notification. 


Queue number of file. 


text card following a file open notification (type 2) must be laid 
as in table 574. 


Table 5-4 


Layout of Text Card 
for File Dpen’ 


-cotumns | contents 


Program name. 
First LSN. 
Second LSN. 
Third LSN. 


Ninth LSN. 


The text of a message from a program or station may contain an NCC» as 
long as the NCC does not cause the MCS to try to send a message to the 
NC. 


OPERATION. 
To run a network simulation: 


ae Set the simulation flag in MCSTIC by using MCSFIT. 
be Start the MCS. 

Ce Start MCSSIM. 

d. After simulation» reset the simulation flag. 


The execution deck for MCSSIM 1s as follows: 


? EXECUTE MCSSIM 
2? DATA MCSSIMCRD 
NS card 

SS card 

header card 

text card 

header card 

text card 


Output messages are Listed ona Line printer. 


MCSEIX.: | | 

The program MCSFIX uses a card deck for patchings Listings and/or re- 
sequencing source files on disk. Source records must be in the UPL 
format: 80 characters longs blocked 45 with sequence numbers in 
positions 73 thru 380. 


Patch cards must also have sequence numbers in columns 73 thru 80. 
Both the patch deck and the input disk file must be tn sequence. 


Program options are specifted on cards which have the character "“#" 
in column 1. Option specifications are free in forms and words are 
separated by blanks. The available options are: 


ae LISI = causes the updated file to be printed on a Line 
printer. 


be. SEQ [base] [tincrement] = causes the output file to be rese- 
quenced. Both “base” and “increment” must be precisely eight 
digits long. 


MCSFIX performs the following patching functions: 


ae Replacement. The sequence number of the new source image 
must match the number of the source image to be replaced. 


b. Insertion. The sequence number of a source image to be 
inserted must not match any in the input file. 


c. Deletion. A *D" in column 72 indicates deletion of a range 
of source records. The lower Limit of the range is in | 
columns 73 thru 80. The upper limit is in cotumns 64 thru 71. 
If only one record is to be deleted» columns 64 thru 71 may 
be left blank. 


To execute MCSFIX» use the following control cards: 


? EXECUTE MCSFIX 

? FILE SOLD NAME input-file~identifier 

? FILE TATAD NAME output-file-identifier 
? DATA CARD 

Coption and patch cards) 

? END 


APPENDIX A 


SUMMARY OF GENERATION PARAMETERS 


Parameter Name Type Default Value 


Routing and Security Parameters 


PROGRAM(1) string 
SID Bootean FALSE 
TBR Boolean FALSE 
ACCESS“SECURITY Boolean FALSE 
TRANSACTION=SECURITY Boolean FALSE 
PROGRAM=SECURITY Boolean FALSE 
TRAN@CODEC 1» 45) string 
TC“COL“~POSITION(C1>j) numer 1c 
PRO“SEC-LEV(1) numeric 

Network Control Parameters 
MGR-STN Boolean FALSE 
MGR-STN=LSN numeric 1 
NCC-OK“RESPONSE string "“$" 
CHANGE“REQ Boolean FALSE 
DATA=DUMP Boolean FALSE 
MSG-BRDCST Boolean FALSE 
MSG-RECALL Boolean FALSE 
PGM-BOJ-EQOJ Boolean FALSE 
STATUS=REP Boolean FALSE 
SYS*HALT Boolean FALSE 
TABLE-DUMP Boolean FALSE 


Audit and Restoration Parameters 


AUDIT Boolean FALSE 
AUDIT~ALL~OUTPUT Boolean FALSE 
AUDIT-PAGE-SIZE numeric 3 

RESTORATION Boolean FALSE 


Operation Parameters 


MAKE=MCSSRC Boolean TRUE 

COMPILE*MCSSRC Boolean TRUE 
MCSSRC“COMPILE-OPTIONS string “NO LIST NO.~DUPLICATES*™ 
MCSSRC“OBJECT-FILE*NAME string "MCSSRC/OBJECT*™ 
MAKE“MCSFIT Boolean TRUE | 

COMPILE-MCSFIT | Boolean TRUE 
MCSFIT“COMPILE-“OPTIONS string "NO LIST NO~DUPLICATES* 
MCSF IT“OQBJECT<-F ILE~NAME string “MCSFIT/OBJECT* 


Aw1 


APPENDIX A (cont) 


Parameter Name 


Type 


MESS Parameters 


GLOBAL-SECTION 
PROCEDURE-SECT EON 
MESS“NAME=STACK-ENTRIES 
MESS-VALUE-STACK=BITS 
MESS“AUDIT 
MESS-AUDIT-NAME 
MESS-CLOSE 
MESS“CLOSE-NAME 
MESS-ERROR 
MESS-ERROR-NAME 
MESS-FROM-PGM 
MESS-FROM=PGM-NAME 
MESS-FROM-STN 

MESS“F ROM=STN-NAME 
MESS=MAINT 
MESS-MAINT-NAME 
MESS-RECALL 
MESS-RECALL~ NAME 
MESS-RESTORE 
MESS“RESTORE-INIT-NAME 
MESS-RESTORE-PROG-NAME 
MESS-SIZE 
MESS-SIZE-NAME 
MESS-VALUE 
MESS~VALUE-NAME 


Miscellaneous Parameters 


PARTICIPATING 
MONITOR | 
SCREEN*WRAPAROUND 
SCREEN@SIZEC1) 
MAX@FILES 
MAX@=LINES 
MAX-PROGRAMS 
MAX@STATIONS 
MAX“TERMINALS 
MAX@“TEXT*SIZE 
MAX=USERS 


Boolean 
Boolean 
numeric 
numeric 
Boolean 
string 
Boolean 
string 
Boolean 
string 
Boolean 
string 
Boolean 
string 
Boolean 
string 
Boolean 
string 
Boolean 
string 
string 
Boolean 
string 
Boolean 
string 


Boolean 
Boolean 
Boolean 
numeric 
numeric 
numeric 
numeric 
numeric 
numeric 
numeric 
numeric 


Default Value 


FALSE 

FALSE 

0 

0 

FALSE 

"MESS-AUDIT"™ 

FALSE 
"MESS.CLOSE.FILES"” 
FALSE 
"MESS.ERROR-HANDLER™ 
FALSE 
"MESS~MSG.FROM.PROGRAM® 
FALSE 
"MESS.MSGeFROM.STATION™ 
FALSE 
"MESS.~MAINTENANCE*® 
FALSE 7 

"MESS -eHANODLE.RECALL*™ 
FALSE 

"MESS.INITIATE RESTORE*® 
"MESS~RESTORE.}j PROGRAM" 
FALSE 

"MESS.SET.SIZES" 

FALSE 

"MESS.SET VALUES" 


FALSE 
FALSE 
FALSE 


oo 
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APPENDIX B 
SUMMARY OF NETWORK CONTROL COMMANDS 


Refer to the paragraph in section 3 entitled Network Control Commands 
for a definition of syntax conventions. 


SECURITY_CONTROL COMMANDS. 
SIGN ON. 
* SGN user-id password 
SIGN OFF. 
* BYE 
ENABLE USER. 
* EYS user-id 
DISABLE USER. 
* DUS user-id 
PROGRAN_CONTROL_ COMMANDS. 
EXECUTE PROGRAM. 
* EX program-name [Ccharge~number ] 
HALT APPLICATION PROGRAM. 
* HAP program-name 
MCS_CONIBOL_COMMANOSs 
AUDIT OK. 
* AQK 
HALT SYSTEM. 
* HLT KILL 
MES2AGE CONTROL COMMANDS. 
BROADCAST. 
* BRC Cstation-specifier] .«... 2 message~text 
POP QUEUE. 
” | eoeemestier cate -_ a 


line-specifier LINE SENQ station-specifier-2 
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APPENDIX B Ccont) 


REPQRT_COMMANDS: 
REPORT DATA OUMP. 
* RDM PRINT 
REPORT FILE STATUS. 
* RES (file-namel] 
REPORT LINE COUNTERS. 
* RLC Cline-specifier] 
REPORT LINE STATUS. 
* RLS Cline-specifier] 
REPORT PROGRAM STATUS. 
* RPS Cprogram-name] 
REPORT STATION COUNTERS. 
eee 
* Rac 
Line-specifier LINE 
REPORT STATION STATUS. 
eee | 


Line-specifier LINE 


* R23 


REPORT TERMINAL STATUS. 
* RIS Cterminal-name] 
CHANGE COMMANDS. 
CHANGE LINE LOCATION. 
* CLL line-specifier port-number channel-number adapter -number 
CHANGE LINE READY. 


R 
* CLB lLine-specifier | 
N 


v 
“7 


CHANGE 


CHANGE 


* 


CHANGE 


CHANGE 


CHANGE 


CHANGE 


CHANGE 


* 


CHANGE 


* 


CHANGE 


CHANGE 


N 
C80 station-specifier 


APPENDIX B (cont) 


MONITOR FLAG. 


CME Cflag-number] ... 


68 
Tn 
iz ~ 
ee eee” 


REPORT VARIABLE. 
CRY time-interval 


STATION ADDRESS. 


CSA station-specifier 


| 
Q 


STATION DIAGNOSTIC. 


STATION ENABLE. 

E 
CSE stattion-specifier 

N 


STATION FREQUENCY. 


CSE station-specifier 


| | 
) . 


STATION MAX“RETRY 

CSM station~specifier retries 

STATION QUEUE. 

C$Q station-specifier-1 station-specifier-2 
STATION READY. 


R 
CSR station~specifier 
| N 


STATION TRANSMISSION NUMBER. 
[ 
Q 


CSI station-specifier | transmisston=number 


APPENDIX C 


SYSTEM REQUIREMENTS 


Peripheral hardware needed to generate and execute a GEMCOS MCS 
includes: 


ae Card reader. 
b. Line printer. 
ce Console printer/keyboard. 


d.- Oisk subsystem. CIf AUDIT is used» at least 4.6 megabytes is 
recommendeds including MCP and NC requirements but excluding 
user's data files.) 


ee Single-line or multiline control. 
f. Magnetic tape Coptional). 


A minimum of 24K bytes of main memory Cexctlusive of MCP requirements) 
is needed to generate an MCS. The smallest MCS that can be generated 
requires 7KB Cexclusive of MCP and NC requirements). Memory require- 
ments increase for each optional feature generated and for each 
additional entry in MCS tables. 


The following chart can be used to estimate core requirements for an 
MCS generated by the GEMCOS system. The calculation of stack sizes as 
performed by the generator ts a relatively complex process» and this 
chart is a simplification of it. Thus» the number appearing on line 43 
is but an estimate of the core requirement. A more accurate estimate 
of the core requirement for a given system can be obtained through the 
CODE/ANALYZER program which 1s part of the B 1700 System Software 
release package. 


The variables that appear in upper case within this chart refer to 
generation parameters used to generate the MCS. 


EILE.SPACEs 
Enter MAX-TEXT-“SIZE on tine i. | 0): eee 
02)_..1333 
If AUDIT ts true then 
enter MAX*=TEXT=SIZE on tine 3» eS rs 
04)... 822 
add tine 3 to line 4 and enter sum 
on line 5» 
else enter zero on Line 5. 09) 2 oh _ 
Add tines 1» 2» 5S and enter sum on Line 6. 06)____ 
DYNAMIC_IABLES: 


Enter MAX=TEXT=SIZE on line 7. oF ge eee eee 
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Enter MAX=TERMINALS on Line 8. 


Multiply line 8 by line 9 and enter 
product on line 10. 


Enter MAX“STATIONS on Line 11. 


Multiply Line 11 by line 12 and enter 


product on line 13. 


Enter MAX=LINES on line 14. 


Multiply tine 14 by line 15 and enter 
product on line 16. 


Enter MAX-FILES on line 17. 


Multiply line 17 by tine 18 and enter 
product on line 19. 


Enter MAX=PROGRAMS on tine 20. 


Multiply tine 20 by line 21 and enter 
oroduct on line 22. 


Enter number of PROGRAM(C1) parameters 
defined on line 23. 


Multiply Line 23 by line 24 and enter 
product on line 25. 


Fnter the Length in characters of the 
Longest transaction code defined through 
TRAN“CODEC1»j) on tine 26. 


Add line 26 to line 27 and enter sum on 
Line 28. 


Enter number of TRAN-CODEC1i,j) pa- 
rameters defined on Line 29. 


Multiply line 28 by line 29 and enter 
product on line 30. 


If RESTORATION its true then 
enter MAX-TEXT-SIZE on Line 31> 


12)....38 


15)... 24 


18)___.14 


21)... 48 


24). 232 


32)____74 


add line 31 to ttne 32 and enter 
sum on line 33>» 
else enter zero on line 33. 


Add lines 7» 10» 13» 16» 19» 22» 255 30» 


enter sum on line 34. 


BASIC_UNIT. 


If AUDIT is true then 
enter MAX=TEXT-SIZE on Line 36>» 


add Line 36 to line 37 and enter 
sum on line 38>, 
else enter zero on line 38. 


If RESTORATION is true then 
enter MAX“TEXT-SIZE on Line 39s 


add tine 39 to Line 40 and enter 
sum on line Gl» 
else enter zero on line 41. 


Add tines 35» 38» 41 and enter sum on 
Line 42. 


ESTIMATE: 


Add lines 6» 34» 42 and enter sum on line 
43. This value is the estimated size in 


bytes of an MCS generated by the GEMCOS 
system. 
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33 and 


io ee 
cL) eee 
359.22 4800 
$60 oo cn 
37)____74 
2 ea 
SS en 
40)____74 
41) 
dp ee ee 
43) 


The disk space requirements for a GEMCOS MCS can be estimated by using 
the following chart. The results of all division calculations should 
be rounded up to the next greater integer if there is any remainder. 


MCOTIC_£CILE. 


Divide MAX-STATIONS by 6 and 
enter the result on tine l. 


Divide MAX“LINES by 8 and 
enter the result on tine 2. 


If access security 1s used» divide 
MAX@“USERS by 10 and enter the 
result on line 3. 


Add lines 1» 2» 3s and 4s and enter 
the sum on Line 5. 
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Multiply Line 5 by Lltne 6 and 06)_...189 
enter the result on line 7. Ren ente ee 
AVOLI_ELLEs 


The disk space used for audit files depends greatly on the operations 
procedures used at a specific installation. The following space 
estimate assumes that nv more than two audit files are on disk at one 
time and that other audit files are stored on some off-line medium 
such as magentic tape. 


Enter MAX-TEXT=SIZE on 


tine 8. | 08) eee 
09) 2 61 
Add Lines 8 and 9» and enter 
the sum on Line 10. bE 1 ae ene 
Enter AUDIT*PAGE“SIZE on 
line 11. 11), Te 
Multiply Line 10 by tine 11 and 
enter the result on line 12. 12)... 
Multiply line 12 by line 13 and 13)... 8Q 
and enter the result on line 14. 14)_ 
ESIIMAIEs 
Add lines 7 and 14» and enter the 
result on line 15. This is eo 9) LE ene 


approximately the amount of 
disk tn bytes needed to execute 
a GEMCOS MCS. 


APPENDIX D 


MCS QUTPUT MESSAGES 


This appendix describes all network messages which the MCS generates to 


inform users of error or other conditions. The general format of a 
system or data communications error message is: 


**ERROR mmm nn = errorsmessage 
The general format of an operator message is: 

72? nn =: message 
The number “nn*™ is the message number. The number "mmm" identifies the 
procedure which discovers the error. fhe latter is provided to aid in 
debugging. 
If the generation parameter DATA-DUMP is set» all error messages num=- 


bered Less than or equal to 21 are accompanied by a table dump. For 
other messages» a dump can be obtained by using the RDM NCC. 


Q. INVALID HALI_CHASEs 


During system shutdowns the current phase of shutdown is different from 


the one expected. 


SUGGESTED ACTION: 
Orderly shutdown may not be possible» and the MCS may have to be 
discontinued. | 


2--ITNVALID STATUS REQUEST. 


During initializations the MCS was sending status requests to the NC» 

and the NC responded with an error message saying some request was not 
valid. As a result» the corresponding entry in the MCS tables is not 

initialized. | 


SUGGESTED ACTION: 
Discontinue the MCS» and execute it again. 


2 -HARDWARE_EXCEPTIION_ON_MCSTIC: 
While reading or writing MCSTIC» the MCS detected a physical disk error 


(such as a parity error). The MCS suspends itself awaiting keyboard 
input from the system operator: 


SUGGESTED ACTION: 

If the operator responds to the ACCEPT» the MCS attempts to shut down 
either gracefully Cif the parameter SYS"HALT was set at generation) or 
directly. Otherwise the MCS must be DS'ted or DP'‘'ed. 


3.-COEON_MCOTIC READ OR WRITES 


The MCS attempted to read or write MCSTIC using an tnvalid record 
number. The MCS suspends itself awaiting a response from the operator 
to an ACCEPT. If the operator respondss the MCS attempts to terminate 
normally. 
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SUGGESTED ACTION: 

Analyze the dump for possible software error. Check the NPR record in 
MCSTIC for invatid record pointers. A new MCSTIC may have to be 
created. 


4_BAD_RECOROD_ID_IN_MCSTIIC. 
The MCS read a MCSTIC records but the ID field at the beginning of the 


record was not the one expected. The MCS suspends itself awaiting a 
response from the operator to an ACCEPT. If the operator responds» the 
MCS attempts to terminate normally. 


SUGGESTED ACTION: 

Analyze the dump for possible software error. Check the NPR record in 
MCSTIC for invalid record pointers. <A new MCSTIC may have to be 
created. 


5 INVALIO_QUIPUI_MESSAGE_-_variant. 


The send routine detected an error in the header of a message that some 
other procedure was trying to send. 


The meanings of the different possible variants are described below: 


ae HAROWR. An attempt was made to send a message to a station 
which can not receive messages because of its hardware type 
(such as a card reader). | 


be. TYPE.~ The message type field in the header does not have a 
valid value. 


ce SIZE. The message text size field in the header is greater 
than the maximum text size as declared at generation. 


de LSNe The togical station number in the header is invalid. 


SUGGESTED ACTION: 

In all of the above cases» the message can not be sent and is dropped. 
It can be recovered from the data dump. This dump should be analyzed 
for a possible software problem. 


O-- INVALID MESSAGE_ SOURCE _ON_SEND: 


When attempting to send a response to an NCC» the MCS discovered that 
the LSN in the header was invalid. 


SUGGESTED ACTION: 
The message can not be sent out and is dropped. It can be recovered 
from the data dump. | 


CMC Se COMMUNICATE BAD_RESULT_COUND. 


The MCS received a non-zero result when sending a message to a station 
or programe. The message 1s dropped. 


SUGGESTED ACTIGN. | 
The message can be recovered from the data dump. 


APPENDIX D Ccont) 


8__INVALID. MESSAGE _OLD_IYPEs 


In response to an MCS communicates» the NC returned a message with itn- 
valid old type. The system may be kept running tn spite of the 
problem. 


SUGGESTED ACTION: 
Check for communication problems between the MCS and the NC. 


2-.LINE READY_DURING CHANGES 


The MCS ordinarily marks tines down before making changess but» in this 
Case» the line was discovered to be up. 


SUGGESTED ACTION: 
The system may be kept runnings but there may be a problem in the 
maintenance module or in the NC. 


10. INVALID MESSAGE_VARIANT. 


The MCS has received from the NC a message whose variant field is not 
zero. 


SUGGESTED ACTION: 
The message is discarded» but can be recovered from the dump. The NC 
1s suspect. 


11__ INVALID. QOPEN_=_SIAILON_MYUSEs 


An application program has attempted to open a remote file containing a 
station whose MYUSE is not consistent with the open type. 


SUGGESTED ACTION: | 
The application program must be discontinued. Either its OPEN must be 
modified or the MYUSE of the station must be changed in NDL. 


12__INYALIO_EILE_CLOSE_-_variant. 

An application program has tried to close a remote file which it did 
not previously open. The close request is ignoredj If “variant™ its 
"INVALID PROG NUMBER,» then the program does not have any remote files 
opens if "FILE NOT OPEN", then it has at least one other remote file 
opene 


SUGGESTED ACTION: 
Scrutinize the application program for possible Logic flaws. 


13._QREN_QDENIED.-_PROGRAM_TABLE_EULL_:_file_orograms 


More application programs have attempted to open remote files than 
were specified by the MAX=PROGRAMS generation parameter. The open 
request is denied» causing a DS or OP condition for the current 
program. 


SUGGESTED ACTION: | 

If it is necessary to have so many programs opening remote files at 
onces MAX“PROGRAMS must be increased. A new MCSFIT program must be 
generated and executed to create a new MCSTIC file. Generation of a 
new MCS 1s not necessary. 
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14__QPEN_DENTEO_.-_EILE_IABLE_EULL_: file programe 

Application programs have attempted to open more remote files then were 
specified by the MAX-FILES generation parameter. The open request 15s 
denieds causing a DS or DP condition for the current program. 


SUGGESTED ACTION: 
Change the MAX“FILES parameter and regenerate the MCS. 


SO. MISSING IBANSMISSION_NUMBER_=_bsn_integere 
The MCS has detected a discontinuity in the transmission number 
sequence. 


SUGGESTED ACTION: 

A transmission number exception may occur due to loss or duplication of 
a message during transmission or as a result of changing the trans- 
mission number within the MCS or the station. The audit file can be | 
analyzed to determine which has happened. The NCC» CST Cchange station 
transmission number)» can be used to synchronize transmission numbers. 


SL..ENOLOEEILE ON AUDITI_EILEs 
while attempting to write the audit file» the MCS has inadvertently 


used an invalid record key. 


SUGGESTED ACTION: 
The MCS logic which computes audit file record keys should be 
investigated for possible flaws. 


32.-HABOWARE_EXCEPTION_ON_ AUDIT _ELLE_=-_keve 
A disk exception occured when the MCS was attempting to write the 
audit file. 


SUGGESTED ACTION: 

The MCS attempts to open a new audit file. If the problem persists» 
the hardware malfunction must be corrected before further processing 
can continue. 


S34. .INVALID_ELILE ATTACH IN_OPEN_ATTIEMPIT_:_station_ file_program.s 

An application program has attempted to open a remote file containing 
a station which is in another remote file already opened. A station 
can not be opened input in two remote files simultaneously. 


SUGGESTED ACTION: 
The application program must be discontinued. 


32.-QPEN_DENTED_-_EAMILY_EILE_REQUIRED_.:_file_orograms 


An attempt was made to open a remote file which was declared as a 
dummy file in NDL. The open request is denied» causing a DS or DP 
condition for the application program. 


SUGGESTED ACTION: 
The FAMILY statement in the NDL specification should be changed to 
include a station identifier list. 
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36._QPEN_DENIEQ.=_SYSTEM_SHUT_QOWN. 


An application program attempted to open a remote file during system 
shutdown. | 


SUGGESTED ACTION. 
The program must be discontinued. 


3Z.QPEN_DENIED_ON_REMOTE_ELLEs 


An application program has attempted to open a remote file ail the 
stations of which are already attached as input to other remote files. 


SUGGESTED ACTION: 

The attachment of all stations can be determined by using the RSS or 
ROM PRINT NCC*s. At least one station of the family must be attachable 
for the open of a remote file to be approved. 


28-3 YTEM_ GOING _OOWN. 


This message is sent to any station which attempts to enter a message 
during system shutdown. The input message is tgnored. 


S2_ IT NVALIO PROGRAM NUMBER. 
The MCS has detected that a program table pointer is out of bounds. 


SUGGESTED ACTION. 
Use the RDM PRINT NCC and the OM console keyboard commands to obtain 
diagnostic information. A monitor listing may also be helpful. 


40. INVALID. TERMINAL _ NAME. 


The terminal name in an RTS NCC was not recognized. 


SUGGESTED ACTION: 
Use the RDM PRINT command to obtain a list of valid names. 


41 NO_ACTIVE PBOGRAM_NAMED_program-name. 


The program named in the NCC either does not exist or does not have a 
remote file open. 


42 -INVALID_-LINE_NAME_Line-=namee 


The line name in the NCC was not recognized. 


43_ INVALID STAITION_NAME_statioo-oames 


The station name in the NCC was not recognized. 


44. NO_ACTIVE_ELLE_NAMEO_file-names 


The file named in the NCC either does not exist or has not been opened. 


43. -INVALID_-INEUI_MESSAGE_=_vaciaots 


When reading from its input queues the MCS detected an error in the 
input message. The type of error is identified by the variant: 


ae TYPE. The message type is not in the range O thru 4. 


be. SIZE. The text size is greater than that which the generation 
parameter MAX-TEXT@=SIZE allows. 
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In either case the message is ignored,» but is printed for debugging 
purposeSse | 


SUGGESTED ACTION: 

A type error in a message from an application program means that the 
program has put a value other than 0 (zero) in the type field of the 
actual key. In case of a size errors longer messages can be allowed 
by changing MAX=TEXT=SIZE and regenerating. 


46. INVALID _OPERATLON mnemonics 


The NCC mnemonic was not recognized. 


47__INVALID_QPTION_items 


Some item expected as an option in an NCC is invalid. 


48. INVALID CHANGE_DATA_items 


The value of a data item in a change NCC is invalid. 


42. COMMAND MISSING DATA_Itema 


An item 1s missing from an NCC. 


20__INVALIO_PQRI_VALUE_item. 


In a CLL command» the port identifier is not valid. 


2L__INVALIO_CHANNEL _VALUE_item. 


In a CLL commands the channel identifier is not valid. 


22.-ITNYALID_ADAPTER_VALUE_items 


In a CLL commands» the adapter identifier is not valid. 


2S--ITNVYALIO_ MONITOR ELAG. 


The flag specification in a CMF command is invalid. 


54__INVALLO_STALION_LISIs 


A 8RC command contains more stations in the destination list than 
exist in the system. 


SUGGESTED ACTION. | 
Use fewer stations in the list. If the list is nulls, the message is 
sent to all stations. 


26. INVALIQ_INCUT_.=_ MISSING SIGNAL CHAR. 


The MCS has received a message from the console keyboard (through 
MCSOLI) and no signal was present at the beginning of the message. 


SUGGESTED ACTION: 
Re-enter the command with the signal Cas declared in NDL) in position 
1. 


iets ealct otra NOT. ALIACHED_=-EILE- NOT_OPEN,: 


A message has been received which neither ts an NCC nor has a trans 
action codes and therefore is to be routed according to file attachments 
however» the originating station is not a part of any open file. 


See 
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SUGGESTED ACTION: 
Execute a program which opens this station tin a remote file. 


23_PROGRAM_NOT_ACTIVE-=_program=names 


The MCS is attempting to route a message via TBRs howevers the 
destination program either does not exist or has not opened a remote 
file. 


SUGGESTED ACTION: 

Send a message to the Network Manager (Cor system operator)» requesting 
him to execute the necessary programe It may be that the parameter 
PROGRAMCI) was specified incorrectly at generation times in which case 
it must be changed. 


22~-ITNVALIO_INEUI_=_IBANS_ELLE_NOT_OPEN. 


The MCS 1s attempting to route a message via TBR» and the destination 
program is actives howevers the program has closed its first-opened 
remote file (the one through which TBR messages are passed). 


SUGGESTED ACTION: 
Either restart the program or start another copy of it. 


60--SECURLIY CATLURE_=_ITNVALID PASSWORD. 


he password in a SGN command does not match the password assigned to 
i user-ID. 


SUGGESTED ACTION: 
Attempt to sign on again with the correct password. 


61__SECURIIY_EAILUBE_=_INVALID_USER-ID. 


The user-ID tn a SGN command is not recognized by the systen. 


62_-2ECURITY CAILURE =_ USERS ID DISABLED. 


The user-ID in a SGN command is disabled. 


SUGGESTED ACTION: 
The user can not sign on until the user-ID is enabled» either by the 


EUS command or by MCSFIT. 


63 -2I1GN-ON_NOT_ REQUIRED. 
A SGN command has been received from a station which either does not 
require signing on or is already signed on. 


SUGGESTED ACTION: 
Proceed with normal transactions as if signed on. 


04_-2ECURITY_FAILURE =-_SIGN-ON_ REQUIRED. 


The MCS has received a message (other than a SGN command) from a sta- 
tion which requires signing on but is currently signed off. The 
message just entered is ignored. 


SUGGESTED ACTION: 
Sign on witth a SGN command. 
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62.-2ECURITY FAILURE _ =. RESTRICTEO PROGRAM. 

A message has been entered by a user or station whose security range 
does not include the security level of the destination program. The 
input message is ignored. 


66__SECURLIY_EALLURE_-~_RESIRICIED_ TRANS. 


A message has been entered by a user or station whose security range 
does not include the security level of the transaction code in that 
message. The message 1s ignored. 


62 abCURITY_EAILURE_-_RESIRICTED_NCC. 

A Network Control Command has been entered from a station that is not 
allowed to execute that command. Most commands are allowed only from 
the Network Manager's station when a Network Manager is signed on. 


68__2I1GNION_COMPLETE_Al_time_QN_ date. 


A SGN command has been successfully processed. 


SUGGESTED ACTION: 
The user 1S now signed ons and interaction with the system may begin. 


@2._21GN-OEE_COMPLETE_AI_time ON dates 


A BYE command has been successfully processed. 


SUGGESTED ACTION: | 
Interaction with the system from this station is prohibited until some 
user successfully signs on again. 


£Q.CUANGE_DENIED: 


The NC has responded to a network change request with a change~dented 
message. 


SUGGESTED ACTIONS: 
The NC should be checked to determine the reason for denial. 


C1 INVALID_CHANGE_ITYPE. 


The NC has found the type code in a network change request to be in- 
valid» that 1s» greater than 9 for a station changes or greater than 1 
for a line change. 


SUGGESTED ACTION: 
The maintenance module of the MCS should be checked for possible 
software error. 


fe. INVALIO_CHANGE_RESULT. 


The NC has made an invalid response to a enauae request from the MCS. 


SUGGESTED ACTION: 
There may be a problem in the logic of the NC. 


eek eben COMMAND: 


he NC has responded to a change request from the MCS» but the response 
1s not what the MCS expected. 


any 
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SUGGESTED ACTION: 
Investigate the maintenance module of the MCS for possible software 
errore 


C4 SENQ_DENTED_ON_CHANGES 
The MCP has found an error in a change request sent from the MCS to the 
NC. 


SUGGESTED ACTION. 

The change command can not be processed. Network activity continues» 
but further change requests may be tgnored. If more changes are 
critical» the system must be shut down and restarted. 


£2.-1NEUT_ TEMPORARILY DENIED _DURING PROGRAM _RESTORATION. 


The MCS has received a message which is bound for a program that is 
undergoing restoration. The input message is ignored. 


SUGGESTED ACTION: 
When restoration 1s complete» enter the message again. Messages may 
be entered for programs not being restored. 


Pcrogcan 


MCSSRC/OBJECT 


MCSFIT/OBJECT 


MCSOLI 


MCSSIM 


MCSFIX 


MCSGO 
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SUMMARY OF FILES 


Iotecnal_Nampe 


MCSTIC 
MCSQUEUE 
MCSBCKLG 
MCSAUDIT 
MC SAUD 
MCSPRINT 


MCSTIC 
MCSFMD © 
MCSPRN 


MCSOLI.PRINT 
MCSOLI.CARD 
MC SQUEUE 


PRINT.OUT 
CARDS 
MCSQUEUE 


SOLD 
TATAD 
CARD 
PRNT 


Device 


DISK 
QUEUE 
QUEUE 
DISK 
DISK 
PRINTER 


DISK 
CARD 
PRINTER 


PRINTER 
CARD 
QUEUE 


PRINTER 
CARD 
QUEUE 


DISK 
DISK 
CARD 
PRINTER 


DISK 
DISK 
CARD 
DISK 
DISK 
DISK 
PRINTER 


Extecoal_Name 


MCSAUDIT/MCSADn 
MCSAUD 


MCSOLIPRT 
MCSOLICRD 


MCSSIMPRT 
MCSSIMCRD 


MCSGTS 
MCSFTS 
MCSCRD 
MCSSRC 
MCSFIT 
MCSTMP 
MCSERN 


E=-1 


Nye 


The data 


ae 


b. 


Following 
reading f 
In mind t 


ae 


De 


Eield=p 


STATI 


ATCHD 


ENBLD 


RDY 
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DATA DUMP DESCRIPTION 


dump tisting 1s logically divided into three parts: 


MCS tables. The contents of the most important tables are 
printed in an easily readable form. 


Current message work area. The work area consists of a header 
and text. The header is used for communication between the 
MCS and the NC. Values of the various fields in the header 
are defined by the NC. The text area is printed in both 
character and hexadecimal format so that all values in the 
text are readable. 


Miscellaneous data items. This information is intended for 
use by technical personnel in diagnosing problems. 


is an exptanation of the fields in the MCS tables. When 
ields that have to do with error statistics» it should be kept 
hat: 


Counters start at zero each time the MCS 158 executed. 


The MCS increments a counter by the retry Limit when the NC 
reports an error to the MCS» but the NC reports an error only 
when the retry limit 1s exceeded. Thus» the number of errors 
printed may be slightly less than the number that actually 
occurred. 


STATION TABLE 


ame Iyae Contents Descriotion 
ON N 171024 LSN of this station. 
A Whether station 1s attached to an open 
remote file. 
A Attached. 
N Not attached. 
A Whether station is enabled. Affected 
by CSE NCC. 
E Enabted. 
N Not enabted. 
A Whether station 1s ready. Affected 
by CSR NCC. 
R Ready. 
N Not ready. 
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Eleldz=name 


SGN 


MGR 


TERM 


LINE 


FILE 


INPUTS 
OUTPTS 
ERRORS 


MYUSE 


ADDRESS 


RTY 


Iyoe 


STATION TABLE 


Cootents 


xe eM 


0-1023 


0-1023 


0-1023 


0-81535 


I 


0 


T/0 


XXX wPXXX 


17230 


Descriotion 


Sign-on status. Affected by SGN and 
BYE NCC‘ts. 


Signed on. 

Not signed on. 

Network manager signed on. 
Sign-on not required. 


Whether this 18 network manager's 
station. 


Manager's station. 
Not manager's station. 


Pointer to terminal table indicating 
the terminal tocated at this station. 


Pointer to the line table entry for 
the Line on which this station is 
Located. 


Pointer to file table entry for file 
to which this station is attached. — 
Zero if not attached. Altered by file 
open and close. 


Number of messages received from this 
station. 


Total number of messages sent to this 
station. 


Number of station errors reported to 
the MCS by the NC. 


Station usage. 
Input. 
Input and output. 


Input and output station addresses. 
Affected by CSA NCC. 


Retry limit. affected by CSM NCC. 


NU? 


Eleld-nape 
FREQNCY 


ALTSTN 


NF 


NS 


NCR 


NCC 


SECURITY 


SCREEN 


ELleid-name 


LINE 


LOCATION 


Lype 


Iyoe 
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STATION TABLE 


Contents Rescciotion 
nnnsnnn Input and output frequency. Affected 
by CSF NCC. 

0-1023 Pointer to the station table entry of 
the station to be used for alternate 
routing. Zero if no alternate routing 
is to be donee. Affected by CSQ NCC. 

0-1023 Value obtained when the hashing func" 
tion was applied to the name of this 
station. 

Whether the NF field 1s a duplicate of 
the same field for some other station. 
D Duplicate. 
U Unique. 
0-1023 Number of network control requests 
| (commands) initiated by this station. 

0-1023 Number of network control commands 

which have affected this station. 
nnenn lower and upper security bounds for 
this station. 

1-1023 Buffer size of device located at this 
station. 

LINE TABLE 

Cootents Description 
nn 17256 The logical line number of this tine. 
nnennsnn Ports» channels» and adapter on which 


this Line is located. Affected by 
CLL NCC. 


Eield-name 


RDY 


INPUTS 


DUTPUTS 


NF 


NS 


ADRESS 


BREAK 


END 8BUFF 


FORMAT 


LOSS DSR 


LOSS CAR 


PARITY 


TIMEOUT 


TRAN NO 
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Ilyage 


A 


LINE TABLE 


Contents 


R 
N 


00-1023 


0-1023 


D 
U 


0-1023 
0-1023 
07-1023 
00-1023 


0-1023 


0-1023 


0-1023 
0-1023 


0~1023 


Descriotion 


Whether the Line is ready. Affected 


by the CLR NCC. 


Ready. 
Not ready. 


Number of input messages received over 
this line. 


Number of output messages sent over 
this line. 


Whether the NF field is a duplicate of 
tion was applied to the name of this 
Line. 


Whether the NF field is a duplicate of 


the same field for some other tine. 


Duplicate. 
Unique. | 


Number of address errors. 
Number of break errors. 

Number of end~-of-buffer errors. 
Number of format errors. 


Number of errors due to loss of data-~ 
setrready. 


Number of errors due to loss of 
Carrier. 


Number of parity errors. 
Number of time-out errors. 


Number of transmission number errors. 


a 


Eleid=pnane 
FILE 


NAME 


VALID 


QUEUE 


STATIONS 


PROGRAM 


Eield=nage 
PROGRAM 


NAME 


VALID 


JOBNUM 


FILES 


[yQe 
N 


A 


Lyee 
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FILE TABLE 
Conteats Descciotion 
1-256 Logical file number of this file. 


V 
N 


0-1023 


0-1023 


O- 31 


PROGRAM 


Contents 


0-31 


Name assigned to this file in file 
section of NDL. 


Whether this file table entry contains 
valid data. Affected by file open and 
close. 


Valid. 
Not valid. 


Number of the program queue for this 
file. 


Number of stations in this file. 


Pointer to the program tabte entry of 
the program that opened this file. 


TABLE 


Desccigtian 
Logical program number of this 
program. 
Name assigned to this program. 
Whether this program table entry | 
contains valid data. Affected by file 


opens and closes. 


Valid. 
Not valid. 


Job number assigned to this program 
by the MCP. 


Number of files currently opened by 
this program. 
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PROGRAM TABLE 


Elieid-=oame Iyge Contents Descrciogtion 
INPUTS N 0-1048575 Number of messages sent to this 
program. 
OUTPUTS N 0-1048575 Number of messages received from this 
program. 
ATACHD N 0-1023 Pointer to the station table entry for 


the first station in the first file 
opened by this program. Used in TBR 
to appease the NC when message origi= 
nate from stations not in the first 
file opened. 


QUEUE N 0-1023 Queue number of the first file opened 
by this program. Used for TBR. 
SECURITY N 0-99 Security levet of this program. 
NONE Program 1s unrestricted. 
SEQUENCE N — -0-999999 Sequence number of last message re- 


ceived by this program during 
restoration. 


RESTORE A Whether the program is undergoing 
restoration. 
R Restoration underway. 
N Normal operation. 
SRCE A Which audit file is to be used for 
restoring this program. 
Cc Current audit file. 
B Backup audit file. 
HOLD A Whether the required audit file is 
available. 
A Available. 
N Not available. 
DATE | N | Date of the audit file from which the 


program is requesting restoration. 


Eleld-name 


TERMINAL 


TYPE 


NAME 


BUFFER 


Eield-nane 


DEFINITION 


NAME 


PROGRAM 


SECURITY 


Tyee 


Tyee 


N 


N 
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TERMINAL TABLE 


Cootents 


1-256 


0-63 


0-4095 


Contents 


1-256 


1-256 


Descrintigon 
Logical terminal number of this 
terminal. 


Type of this terminal as defined in 
terminal section of NOL. 


Name of this terminal as defined in 
terminal section NDL. 


Buffer size of this terminal as de- 
fined tn MAXINPUT statement of NDL. 


PROGRAM DEFINITION TABLE 


Descciotion 


Logical program definition number 
of this program definition. 


Name associated with this program def- 
inition. Defined by the generation 
parameter PROGRAM. 


Pointer to the program table entry 
which represents an active copy of 
this program definition. Used to 
obtain the queue number for TBR. 


Security level of this program. 


F~7 
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Eield-oame 


TRAN CODE 


POSITION 


LENGTH 


POT LINK 


SECURITY 


Tyee 


TRANSACTION TABLE 


Cooteots 


0-99 


Descriotion 


The transaction code defined by the 
TRAN“CODE generation parameter. 


Location in text of the transaction 
code. 


Length of transaction code in 
characters. 


Pointer to the program definition 
table entry which contains the name 
the program to which a message con- 
taining this transaction code is to 
routed. 


Security tevel of this transaction. 
code. 


of 


be 


APPENDIX G 
EXAMPLE OF ROUTING AND 
SECURITY SPECIFICATIONS 


Routing and security are specified by a combination of generation 
parameters and MCSFIT cards. Consider the following specifications: 


GENERATION PARAMETERS 
Zxx« TBR = TRUE. 
Z*xxe ACCESS“SECURITY = TRUE. 
Axxe TRANSACTION“SECURITY = TRUE. 
Ax«xkz PROGRAM<“SECURITY = TRUE. 
A*ke*k PROGRAM(1) = ON PGMA* 
4*xxkx PROGRAM(2) = PGMB" 
Z*xxe PROGRAM( 3) =" PGMC*™ 
Aeae PRO-SEC@“LEVC1) = 25. 
Z*ke PROW-SECALEVC2) = 50. 
Beek PROWSEC*LEV( 3) = 75-6 
Ax«ze TRAN“CODEC1,1) = “"ENQ™. 
Zxxe TRAN“CODEC1»2) = *"UDT". 
Z*x« TO“COL“POSITION( 151) = 1. 
Axxe TOC“COL“POSITION( 1,2) = l. 
Z*xx*e TC-SEC“LEV(C 1.1) = 50. 
Axekx TOMSEC“LEVC 1.2) = 10. 
%xxke MAX-USERS | = 15. 
Lexx MGR<-STN = TRUE. 
Z*xx%e MGR-STR-“LSN = Le 


MCSFIT CARDS 


1 
1234567890123456789 


USRAAABPASSABO199YY 
USRBBBBPASSBB5075YN 
USRBBBDPASSBD2550NN 
USRBBBEPASSBE1OSONN 
STRO015050 


The above example describes a system which has four users and three 
programs. The station which has LSN 001 does not require signing on. 
Onty users AAAB and BBBB can sign ons since the others are disabled. 
(The Network Manager could enable them through the EUS command.) The 
transaction code “ENQ" can be entered by any user since its security 
level is within the security range of all users and of station 001. 
Likewises the program PGMB can be used by any user via file attachment. 
User AAAB 1s defined as a Network Managers and station 002 as a Network 
Manager's station. When user AAAB is signed on at station 002» he can 
perform restricted NCC*s. In additions user AAAB can use any program 
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or transaction since his security range extends from 01 thru 99. User 
BBBB Cwhen enabled) is allowed to use PGMBs PGMCs» and the ENQ 
transaction code. User BBBD is allowed to use PGMA» PGMB» and the ENQ 
transaction code. User BBBE is allowed to use both transaction codes 
as well as PGMA and PGMB. Transactions ENQ@ and UDT are routed to PGMA | 
however» PGMA may receive other transactions via file attachment. The 
MAX“USERS parameter 1s set to 15 to allow for possible expansion. 


INDEX 


Access Security 

(See Security) . 
ACCESS“SECURITY Parameters 3-2» 3-3» 3°17 
Actual Keys 2-1» 2-2.» 3-13 
Address of Stations 3-48 
Application Program Interfaces 2-1» 3-12 
Audits 2°62 2-79 376.» 3°17» 3-312 4-39 4-40 C-4 
AUDIT Parameters 3-6 
AUDIT-“ALL“OUTPUT Parameters 3-6 
AUDIT“PAGE-SIZE Parameter» 3-6 


CHANGEWREQ Parameters 3-45 3-5e» 3-11» 3-716 
Clear/Starts» 4-4 | 
COMPILE-*MCSFIT Parameters» 3-7» 4-1 
COMPILE“MCSSRC Parameters 3-7» 4-1 


Data Dumps 2°75» 2°85» 3°59 3718» 3°36» 37475 Dl» Fil 
DATADUMP Parameters 3-74» 3°55 37-16% 3-35» D-1 
Debugging» 275s» 2-8» 2-9» 3-20 


End-of-Files, 2-7» 3-30 
Frror Handlings 275» 2-7» 3°18s 3-52 


FAMILY Statement of NDL» 2-1» 2~2 
Frequencys 3-751 


Generations i-ils 3-7» 4-1 

Generation Flows 4-2 

Generation Parameters» 173% 2745 2-89 2-95 3-15 4-15 Anil 
Generator Programs 1-3» 278» 378s 37-13% 3-205 4-1 


Line Section of NDL» 3-24 
Logical Station Number (CLSN)» 2-15 2-25 3-5» 3-11» 37125 3-249 5-5 


MAKE*MCSFIT Parameters» 3-7» 3-20» 4-1 
MAKE“MCSSRC Parameters 3-7 
MCSFIT>» 1-3» 272» 276% 2792 327-32 3=7e 37199 3°200 Awl» 4°20 5-5 
MCSFIT*COMPILE“OPTIONS Parameters 3-7 
MCSFIT“OBJECT“FILE-“NAME Parameters» 3-7 
MCSFIXs» 1-3» 576 
MCSGO 
(See Generator Program) 
MCSOLI» 1-35 3-315 4-4e 5-1 
MCSSIMs 1-35 5-2 
MCSSRC“COMPILE-“OPTIONS Parameters, 3-7 
MCSSRC“OBJECT<“FILE-NAME Parameters, 3-7 
MCSTIC>» 1°32» 2-29 276» 3739 37-20% 37°252 4-229 575 
MCSTIC Card Layouts» 3-215 3-22 3 
Mergeable External Source Statements (MESS )» 2-°7>» 2-85 3-Bse 3-135 3-19» 
4-1 | 
Message Types 2=1s 276s» 37125 37135 3°19 
Message Text Size» 2-1» 3-1ll» 3°12» 37-13» 3714 
Metalanguage» 3-23 
MGR-STN Parameter 3-4 3-5 
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Monitors 278s 2-99 3°19» 3-46 

MONITOR Parameters 3-11» 37°17» 3719» 3744 
MSG-BRDCST Parameters 3-45 3°52 3-16» 3-33 
MSG-RECALL Parameters 3-42 37-52 3-7» 3734 


Name Stack» 3-9» 3-10 

NCC“OK"“RESPONSE Parameters 3-45 3-5» 3°23 

NDL» 2-1lse 2-20 3r7lle 3°23% 32724» 3-49 

Network Controller CNC)» 171s 242 2-5 2°7e 37185 37355 3-Sh4e 4°3> 
5-29 575s Fol 

Network Control Commands (CNCC)» 274» 2-5s 277s 2-Be 3-49 3-5» 3-15» 
3716» 37195 3-22 thru 3°55» S-1l» 5-25 5-5» B-l 

Network Managers 2-45 2-5» 3-4 3-5 


Operator 
Consoles 2755 276s 4-74 
Stations 275» D-2 
Operations 3-77.» 4-1 


PARTICIPATING Parameters 3-35 3-11 
Passwords 2-2» 3°25s 3-27 
PGM-BOJ-ECJ Parameters 3-4 3-5» 3-17» 3-29 
Process Security 

(See Security) 
PROGRAM Parameters 3-2» 3-3 
Program Security 

(See Security) 
PROGRAM*SECURITY Parameters 3-2» 3-3 
PRO“SEC“LEV Parameters 3-2» 3-39 374 


Recovery 
(See Restoration) 
Remote Files 2-1» 2-2» 3-1il» 3-37» 3-40 
Restorations 2-l» 275%» 276% 278» 37-6» 3-132 4°35» 4-4 
RESTORATION Parameters 3-6» 3°17» 3°19 
Routings 274» 2-7» 3-53 Grl 
(See also Transaction Based Routing) 


Securitys, 2729 273» 274s 3-20 3-32 3745 3°15» 37°25» Gril 
Shutdowns 2-7» 3718» 32-32 
SID 
(See Supplementary Information Data) 
SID Layouts 3-12 
SIO Parameters 3-3 
Simulations 173» 5-2 
Sign On/Off» 2-22 2-3» 2-49 2-52 3-179 3725» 3°26% 3°27 3728 
Stack sizes» Calculation of» 3-9» 3-10 
Station Section of NDOL» 3-12» 3-235 3-24 
Statisticss 2-5» 3-35» 3-38» 3-415 Fri 
STATUS“REP Parameters 3-45 3-5» 3-175 3-35 | 
Supplementary Information Data (SID)» 2t1le 276» 3-25 3-35 S712 3-13>- 
3715,» 3-16 | 
Syntax Conventions» 3-23 
System Structures i-2 
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SYS“HALT Parameters 3-45 3°55 3°17% 3-32 


Table Dump 

{See Data Dump) 
TABLE=DUMP Parameters 3-4» 375» 3°17 3-44 
TBR 

(See Transaction Based Routing) 
TBR Parameters 372s» 3-3 
TC“COL“POSITION Parameters 3-25 3-35 334 
TC*SEC*LEVEL Parameters 3-25 3-3» 324 
Terminal Section of NOL» 3-12 
Terminal Types 2-1» 3°12 
Testings 1-3» 5-2 
Transaction Codes 2"*1» 3-4 
Transaction Based Routing (CTBR)» 2=29 2-4n 32°25 323% 374 
Transaction Security 

(See Security) 
TRANSACTION“SECURITY Parameters 3-2» 373 
TRAN*CODE Parameterr> 3725 3-3» 374 
Transmission Numbers 3-55 


UPL» 277s 377s 3-20» 56 
User-1Ds» 2-2» 327329 3°25» 3727s 3728 


Value Stacks» 3-9» 3-10 
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